Post #997873

2026-04-07 07:25 UTC

Those of you who work in an organisation that makes heavy use of GenAI coding assistants: how did you educate your developers that if they automate sweeping changes to user-facing code, they MUST also automate the corresponding sweeping changes to user-facing documentation? Or have you identified a strong correlation between embracing GenAI coding assistants and not giving a flying fuck about user-facing docs?

Replies (4)

@krig@goto.liten.app 2026-04-07 07:28

@xahteiwi ”not giving a flying fuck” I think this is the baseline we’re working from in general, sadly

Open ##1251383
@larsmb@mastodon.online 2026-04-07 07:34

@xahteiwi It still goes through QA, review and everything, so all of that still happens. Edit: partly because GenAI ingests the user facing docs, so if you want your product to work somewhat better in an "AI-assisted" world and ops and agents, those docs better be close enough to right.

Open ##1251384
@hikhvar@norden.social 2026-04-07 07:44

@xahteiwi Using Docs to tell them to update User Facing docs (agent.md or development.md). The only thing GenAI Agent do better than the average human developer is reading markdown docs and following it.

Open ##1251385
@cdf1982@iosdev.space 2026-04-07 09:10

@xahteiwi TBH is on of the parts in which AI has improved things the most: a /document skill.md not only instructs Claude to do a diff and update docs accordingly

Open ##1251396