Documentation in the browser
While topic-based and docs as code are typically local files on a person’s computer, many teams create documentation straight into a browser. This could be via a documentation-specific content management system or a wiki-style system, where writers can create links between content items on the fly (the classic example is Wikipedia).
On the positive side, anyone with an account can contribute, and the toolchain is in place, standard, and kept up to date for all users at the same time.
On the negative side, user-installed browser extensions aside, what you’re given is what you get, you generally need to pay, and while browser tools are far more powerful than ever, integration options are limited.
Some popular options for writing documentation in the browser include the following:
- GitBook (https://www.gitbook.com): A hybrid of docs as code and browser-based, GitBook attempts to combine many of the positives of both into a tool...
