[kazinator]

Deborah Writes ... ESL-level gibberish.

I can't parse the title or the first sentence.

Does she mean doc-like code?

[theletterf]

This comment goes against the spirit of respect that should reign on HN. Please contribute only if you've anything remotely interesting to say -- thank you!

[keybored]

Skimming the text it seems okay. Relatively simple sentences (simple sentences are not necessarily good, depends on the complexity of the subject). A string of simple statements are used to continue the narrative. More complex sentences are built up with a few colons (should be semicolons) and a stringing together of commas that I personally will never get used to.

[PhilipRoman]

https://www.writethedocs.org/guide/docs-as-code/

Docs like code is a single term, maybe capitalization or dashes would help

[DeborahWrites]

Capitalization would probably be a good idea, based on the comments here! Thanks!