News for hackers. Stuff that matters.
Re:“This is the worst documentation I have ever seen in my l... by twblalock on Monday December 14, 2020 @04:04PM (#25423296)
This is why I prefer to link to actual code in the repo, in an examples directory, which gets compiled during every build.
Re:“This is the worst documentation I have ever seen in my l... by qayxc on Monday December 14, 2020 @04:25PM (#25423558)
Unfortunately that doesn't help if the documentation is written by a different team and in a different format.

Getting out of sync happens very quickly if docs aren't generated from source and aren't an integral part of the release process.

Re:“This is the worst documentation I have ever seen in my l... by dgb23 on Monday December 14, 2020 @04:19PM (#25423468)
This is not only simple and comprehensive but also doesn't require any special support from the tooling or language. Love it!