The more questions I ask, the more it seems that people have slightly different ideas about the definition of the term "Docs as code." Here's one definition, based on some of the best-known resources about docs as code. * The docs are written in plain text.
"The last bullet is the most frequently omitted from definitions of docs as code, but I would say that it's the most important." — I agree that this is often very important, but docs as code has strong benefits even where the process does not involve software developers *at all*.
That's because a docs as code toolchain can make documentation *much* easier to track, review, maintain and deploy than is often the case with more traditional approaches. This means that technical writers can publish specific updates and fixes to documentation faster, with better traceability.
That's all extremely beneficial to any organisation, not just those that revolve around software developers.
"The last bullet is the most frequently omitted from definitions of docs as code, but I would say that it's the most important." — I agree that this is often very important, but docs as code has strong benefits even where the process does not involve software developers *at all*.
That's because a docs as code toolchain can make documentation *much* easier to track, review, maintain and deploy than is often the case with more traditional approaches. This means that technical writers can publish specific updates and fixes to documentation faster, with better traceability.
That's all extremely beneficial to any organisation, not just those that revolve around software developers.