And then they hand-wring about silos. The level of slop at software companies is astounding. Let’s drop everything to make sure we’re writing the backend and frontend in the same language, and then half-document everything over Slack, Confluence, README.mds, and GitHub wikis.
Confluence is especially stupid to me when everything happens on GitHub anyway, and most companies do GitOps in one form or another. We can literally colocate documentation next to the same code files it applies to, using a nice terminal friendly markup language. Most programming languages these days allow us to write Markdown documentation inline next to the declaration it applies to. But no, let’s use Atlassian’s bespoke proprietary Enterprise Offering of a rich text editor. Disgusting.
But hey, suits need to sell their enterprise software to somebody.
Confluence is especially stupid to me when everything happens on GitHub anyway, and most companies do GitOps in one form or another. We can literally colocate documentation next to the same code files it applies to, using a nice terminal friendly markup language. Most programming languages these days allow us to write Markdown documentation inline next to the declaration it applies to. But no, let’s use Atlassian’s bespoke proprietary Enterprise Offering of a rich text editor. Disgusting.
But hey, suits need to sell their enterprise software to somebody.