4 ms·
In our work, all the technical documents are published on our intranet site. We discourage printed documentation as it can quickly get out of date and under pr
by CyberFonic 8y ago
In our work, all the technical documents are published on our intranet site. We discourage printed documentation as it can quickly get out of date and under pressure people have been known to use the wrong documents and make the problem they are trying to solve worse. Of course, you can always print from website if heading into a secure data centre where external access is locked down and unvetted notebooks are not permitted.
Most of the documents are created in MarkDown and the web pages are updated using Makefiles. Diagrams are preferably in GraphViz, compiled to PNGs and included as images. When GraphViz is unsuitable, LibreOffice draw and export as PNGs.
We also take high-res photos of equipment layouts, etc, annotate them with GIMP and include the exported JPGs.