News for hackers. Stuff that matters.
Re:Diagrams · Diagram as Code by Waterluvian on Monday November 04, 2024 @09:04PM (#42048002)
I hear you, oh my how I hear you.

I’ve finally found a happy middle at work where I version control the markdown based “user manual” and API specs/docs, but the design pages, rich with graphs and diagrams are going to live on the corporate wiki and require that I just learn to be disciplined to keep them up to date.

Surely I can just do that and not everything has to be… I dunno what to call it… that thing where us programmers love to see every human process problem as requiring a technical solution.

Re:Diagrams · Diagram as Code by darau1 on Tuesday November 05, 2024 @05:35PM (#42055787)
I'd end up with something like this if I ever had the time. Instead of a corporate wiki, though, I'd probably use something like sphinx to compile PDF files, and store them on the public workspace.