Learn to integrate programming with good documentation. This book teaches you the craft of documentation for each step in the software development lifecycle, from understanding your users’ needs to publishing, measuring, and maintaining useful developer documentation. Well-documented projects save time for both developers on the project and users of the software. Projects without adequate documentation suffer from poor developer productivity, project scalability, user adoption, and accessibility. In short: bad documentation kills projects. Docs for Developers demystifies the process of creating great developer documentation, following a team of software developers as they work to launch a new product. At each step along the way, you learn through examples, templates, and principles how to create, measure, and maintain documentation—tools you can adapt to the needs of your own organization. What You'll Learn Create friction logs and perform user research to understand your users’ frustrations Research, draft, and write different kinds of documentation, including READMEs, API documentation, tutorials, conceptual content, and release notes Publish and maintain documentation alongside regular code releases Measure the success of the content you create through analytics and user feedback Organize larger sets of documentation to help users find the right information at the right time Who This Book Is For Ideal for software developers who need to create documentation alongside code, or for technical writers, developer advocates, product managers, and other technical roles that create and contribute to documentation for their products and services.
"Learn how to have great conversations through your site or app. Meet your business goals while satisfying your site visitors' needs. Learn how to create useful and usable content from the master - Ginny Redish. Ginny's easy-to-read style will teach you how to plan, organize, write, design, and test your content"--
Looking for a way to invigorate your technical writing team and grow that expertise to include developers, designers, and writers of all backgrounds? When you treat docs like code, you multiply everyone's efforts and streamline processes through collaboration, automation, and innovation. Second edition now available with updates and more information about version control for documents and continuous publishing.
A compendium of delightful essays, poems, photos, quotations, and illustrations for book lovers. For anyone who’d rather be reading than doing just about anything else, this ebook is the ultimate must-have. In this visual ode to all things bookish, readers will get lost in page after page of beautiful contemporary art, photography, and illustrations depicting the pleasures of books. Artwork from the likes of Jane Mount, Lisa Congdon, Julia Rothman, and Sophie Blackall is interwoven with text from essayist Maura Kelly, bestselling author Gretchen Rubin, and award-winning author and independent bookstore owner Ann Patchett. Rounded out with poems, quotations, and aphorisms celebrating the joys of reading, this lovingly curated compendium is a love letter to all things literary, and the perfect thing for bookworms everywhere.
Anne Gentle's "Conversation and Community" has become the go-to reference for social media and technical communication. Her clear-eyed survey of the social media landscape has been adopted by many universities and is widely used by technical communicators. Now, in this second edition, she has updated and expanded her book, adding chapters on building a content strategy, analyzing web techniques, and developing an open source strategy. With more interviews and case studies, this is your guide to the new world of technical communication and social media. Inside the Book Towards the Future of Documentation Defining a Writer's Role with the Social Web Community and Documentation Commenting and Connecting with Users Wikis as Documentation Systems Finding Your Voice Content Strategy for Community Documentation NEW Chapter Analyzing and Measuring Web Techniques NEW Chapter Open Source Documentation NEW Chapter Concepts and Tools of the Social Web Glossary, Expanded Bibliography, and Index
Discusses how to develop one's art career by selling and showing more of one's work, covering how to get organized, assemble a portfolio, create marketing materials, use a Web site to one's advantage, and speak confidently about one's identity as an artist.
George Orwell set out ‘to make political writing into an art’, and to a wide extent this aim shaped the future of English literature – his descriptions of authoritarian regimes helped to form a new vocabulary that is fundamental to understanding totalitarianism. While 1984 and Animal Farm are amongst the most popular classic novels in the English language, this new series of Orwell’s essays seeks to bring a wider selection of his writing on politics and literature to a new readership. In Why I Write, the first in the Orwell’s Essays series, Orwell describes his journey to becoming a writer, and his movement from writing poems to short stories to the essays, fiction and non-fiction we remember him for. He also discusses what he sees as the ‘four great motives for writing’ – ‘sheer egoism’, ‘aesthetic enthusiasm’, ‘historical impulse’ and ‘political purpose’ – and considers the importance of keeping these in balance. Why I Write is a unique opportunity to look into Orwell’s mind, and it grants the reader an entirely different vantage point from which to consider the rest of the great writer’s oeuvre. 'A writer who can – and must – be rediscovered with every age.' — Irish Times
For so many people, reading isn't just a hobby or a way to pass the time--it's a lifestyle. Our books shape us, define us, enchant us, and even sometimes infuriate us. Our books are a part of who we are as people, and we can't imagine life without them. I'd Rather Be Reading is the perfect literary companion for everyone who feels that way. In this collection of charming and relatable reflections on the reading life, beloved blogger and author Anne Bogel leads readers to remember the book that first hooked them, the place where they first fell in love with reading, and all of the moments afterward that helped make them the reader they are today. Known as a reading tastemaker through her popular podcast What Should I Read Next?, Bogel invites book lovers into a community of like-minded people to discover new ways to approach literature, learn fascinating new things about books and publishing, and reflect on the role reading plays in their lives. The perfect gift for the bibliophile in everyone's life, I'd Rather Be Reading will command an honored place on the overstuffed bookshelves of any book lover.
Unlock your writing potential with Dorothea Brande's classic guide, "Becoming a Writer." This book provides aspiring writers with essential tools and techniques to develop their craft and cultivate a disciplined writing habit. Brande's practical advice and inspirational insights will empower you to overcome creative blocks and bring your literary dreams to life. Start your journey towards becoming a confident and successful writer today.