3 ms·
At work I just made a huge organization overhaul. Previously, the entire state of a project was scattered throughout some markdown files in an absurdly complex
by missjellyfish 7y ago
At work I just made a huge organization overhaul. Previously, the entire state of a project was scattered throughout some markdown files in an absurdly complex git repository, a gitlab wiki and a stash of hand-written notes.
It's now all nice and tidy in a Confluence space. Let's see how it goes and how this holds up when more people start working on this project again. I for myself are diciplined enough to care about good documentation, but my last colleagues left a huge pile of chaos which took a few months to sort out after they left.
- sniuff 7y agoHave you thought about having markdowns rendered to a Confluence page? And maybe Confluence edits could get rendered back to git. For the first use case, there are libraries available that sync your .md to Confluence which you could add to your CI system.
- khakkarainen 7y agoWith a bit of tweaking, Pandoc does a good job of rendering HTML that Confluence likes. I wrote some scripts a couple of years ago to do this, using the Confluence API to add and update pages. It’s also possible to do a round-trip because someone will invariably edit the Confluence page.