Zum Hauptinhalt springen
Dekorationsartikel gehören nicht zum Leistungsumfang.
Docs for Developers
An Engineer¿s Field Guide to Technical Writing
Taschenbuch von Jared Bhatti (u. a.)
Sprache: Englisch

67,90 €*

inkl. MwSt.

Versandkostenfrei per Post / DHL

Lieferzeit 1-2 Wochen

Kategorien:
Beschreibung
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 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.
Über den Autor

Jared Bhatti

Jared is a Staff Technical Writer at Alphabet, and the co-founder of Google's Cloud documentation team. He's worked for the past 14 years documenting an array of projects at Alphabet, including Kubernetes, App Engine, Adsense, Google's data centers, and Google's environmental sustainability efforts. He currently leads technical documentation at Waymo and mentors several junior writers in the industry.
Sarah Corleissen
Sarah (she/her, they/them) began this book as the Lead Technical Writer for the Linux Foundation and ended it as Stripe's first Staff Technical Writer. Sarah served as co-chair for Kubernetes documentation from 2017 until 2021, and has worked on developer docs previously at GitHub, Rackspace, and several startups. They enjoy speaking at conferences and love to mentor writers and speakers of all abilities and backgrounds.
Heidi Waterhouse
Heidi spent a couple decades at Microsoft, Dell Software, and many, many startups learning to communicate with and for developers. She currently works as a principal developer advocate at LaunchDarkly, but was reassured to find that technical communication is universal across all roles.

David Nunez

David heads up the technical writing organization at Stripe, where he founded the internal documentation team and wrote for Increment magazine. Before Stripe, he founded and led the technical writing organization at Uber and held a documentation leadership role at Salesforce. Having led teams that have written about cloud, homegrown infrastructure, self-driving trucks, and economic infrastructure, he's studied the many ways that technical documentation can shape the user experience. David also acts as an advisor for several startups in the knowledge platform space.
Jen Lambourne
Jen leads the technical writing and knowledge management discipline at Monzo Bank. Before her foray into fintech, she led a community of documentarians across the UK government as Head of Technical Writing at the Government Digital Service (GDS). Having moved from government to finance, she recognizes she's drawn to creating inclusive and user-centred content in traditionally unfriendly industries. She likes using developer tools to manage docs, demystifying the writing process for engineers, mentoring junior writers, and presenting her adventures in documentation at conferences.
Zusammenfassung

Aligns the craft of writing with the craft of programming

Contains easy-to-follow processes, templates, and best practices for creating, organizing, and maintaining documentation

Written by experienced writers and developers from Google, The Linux Foundation, Stripe, LaunchDarkly, and Monzo,

Inhaltsverzeichnis
1. Getting Started.- 2. Researching Documentation.- 3. Designing Documentation.- 4. Drafting Documentation.- 5. Structuring Sets of Documentation.- 6. Integrating Code Samples and Visual Content.- 7. Measuring Documentation Success.- 8. Working With Contributors.- 9. Maintaining Documentation.- 10. Wrapping Up.

Details
Erscheinungsjahr: 2021
Genre: Informatik
Rubrik: Naturwissenschaften & Technik
Medium: Taschenbuch
Inhalt: xxv
225 S.
31 s/w Illustr.
225 p. 31 illus.
ISBN-13: 9781484272169
ISBN-10: 1484272161
Sprache: Englisch
Ausstattung / Beilage: Paperback
Einband: Kartoniert / Broschiert
Autor: Bhatti, Jared
Corleissen, Sarah
Waterhouse, Heidi
Nunez, David
Lambourne, Jen
Auflage: 1st ed.
Hersteller: Apress
Apress L.P.
Maße: 235 x 155 x 14 mm
Von/Mit: Jared Bhatti (u. a.)
Erscheinungsdatum: 01.10.2021
Gewicht: 0,388 kg
Artikel-ID: 120197028
Über den Autor

Jared Bhatti

Jared is a Staff Technical Writer at Alphabet, and the co-founder of Google's Cloud documentation team. He's worked for the past 14 years documenting an array of projects at Alphabet, including Kubernetes, App Engine, Adsense, Google's data centers, and Google's environmental sustainability efforts. He currently leads technical documentation at Waymo and mentors several junior writers in the industry.
Sarah Corleissen
Sarah (she/her, they/them) began this book as the Lead Technical Writer for the Linux Foundation and ended it as Stripe's first Staff Technical Writer. Sarah served as co-chair for Kubernetes documentation from 2017 until 2021, and has worked on developer docs previously at GitHub, Rackspace, and several startups. They enjoy speaking at conferences and love to mentor writers and speakers of all abilities and backgrounds.
Heidi Waterhouse
Heidi spent a couple decades at Microsoft, Dell Software, and many, many startups learning to communicate with and for developers. She currently works as a principal developer advocate at LaunchDarkly, but was reassured to find that technical communication is universal across all roles.

David Nunez

David heads up the technical writing organization at Stripe, where he founded the internal documentation team and wrote for Increment magazine. Before Stripe, he founded and led the technical writing organization at Uber and held a documentation leadership role at Salesforce. Having led teams that have written about cloud, homegrown infrastructure, self-driving trucks, and economic infrastructure, he's studied the many ways that technical documentation can shape the user experience. David also acts as an advisor for several startups in the knowledge platform space.
Jen Lambourne
Jen leads the technical writing and knowledge management discipline at Monzo Bank. Before her foray into fintech, she led a community of documentarians across the UK government as Head of Technical Writing at the Government Digital Service (GDS). Having moved from government to finance, she recognizes she's drawn to creating inclusive and user-centred content in traditionally unfriendly industries. She likes using developer tools to manage docs, demystifying the writing process for engineers, mentoring junior writers, and presenting her adventures in documentation at conferences.
Zusammenfassung

Aligns the craft of writing with the craft of programming

Contains easy-to-follow processes, templates, and best practices for creating, organizing, and maintaining documentation

Written by experienced writers and developers from Google, The Linux Foundation, Stripe, LaunchDarkly, and Monzo,

Inhaltsverzeichnis
1. Getting Started.- 2. Researching Documentation.- 3. Designing Documentation.- 4. Drafting Documentation.- 5. Structuring Sets of Documentation.- 6. Integrating Code Samples and Visual Content.- 7. Measuring Documentation Success.- 8. Working With Contributors.- 9. Maintaining Documentation.- 10. Wrapping Up.

Details
Erscheinungsjahr: 2021
Genre: Informatik
Rubrik: Naturwissenschaften & Technik
Medium: Taschenbuch
Inhalt: xxv
225 S.
31 s/w Illustr.
225 p. 31 illus.
ISBN-13: 9781484272169
ISBN-10: 1484272161
Sprache: Englisch
Ausstattung / Beilage: Paperback
Einband: Kartoniert / Broschiert
Autor: Bhatti, Jared
Corleissen, Sarah
Waterhouse, Heidi
Nunez, David
Lambourne, Jen
Auflage: 1st ed.
Hersteller: Apress
Apress L.P.
Maße: 235 x 155 x 14 mm
Von/Mit: Jared Bhatti (u. a.)
Erscheinungsdatum: 01.10.2021
Gewicht: 0,388 kg
Artikel-ID: 120197028
Warnhinweis

Ähnliche Produkte

Ähnliche Produkte