Get the latest tech news

What docs-as-code means


I’ve recently started a new job as a documentation engineer. My work is largely the same as that of a technical writer, but the sound and semantics of my new title gave me some pause and made me think about what it really means to be doing docs-as-code.

I’ve built a career around the belief that technical writers are essential to all kinds of engineering efforts and deserve the same level of respect, resources, and recognition as their peers. Ignore docs and users just won’t know about the new feature you just launched, your growth KPIs taking such a heavy hit that you wished you had something more than a newsletter. Instead of taking away writing duties from software developers, the existence of technical writers increases the visibility and importance of docs, promotes best practices, and creates a sense of shared ownership of documentation.

Get the Android app

Or read this on Hacker News

Read more on:

Photo of Docs

Docs

Photo of Code

Code

Photo of means

means

Related news:

News photo

Expanding Our Code of Conduct to Protect Private Conversations

News photo

You Can Now See the Code That Helped End Apartheid

News photo

INC ransomware rebrands to Lynx – same code, new name, still up to no good