Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

This is a dismissive position.

The point of "docs-as-code" is not "code that produce docs", but "docs treated as code", that is, versioned in a VCS and built using similar workflows as the code they document. It's also a way of bringing technical writers and developers together and collaborate more.



Yep, and "docs-as-code" is an established concept in the technical writing world. Ask almost any software tech writer[0] about docs-as-code and they'll know what you're referring to.

[0] Maybe barring the tech writers who are still stuck using FrameMaker and the like.


or Microsoft document formats.




Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: