4 ms·
Every engineer I met dislikes Confluence. Engineers who write most of the documentation don't like using Confluence which lead to out dated, subpar and incomple
by alienreborn 8y ago
Every engineer I met dislikes Confluence. Engineers who write most of the documentation don't like using Confluence which lead to out dated, subpar and incomplete documentation.
In my org, I noticed this and created a github repo to push documentation in Markdown. I created initial version of docs and now every engineer in our team uses it because they know markdown, appreciate version controlled docs and can use whatever editor they want to. This repo is now filled with quality documentation for most of our stack and operations.
- nwatson 8y agoI'm an engineer and love Confluence + Gliffy. Writing fully interlinked documentation with illustrations and tables and styling is much easier than with any other tool.
- my_usernam3 8y agoI'll second the love for Confluence as an engineer. Easy to use and navigate imo. Hate JIRA with a passion though, at least the two implementations I've use have been exhausting with fields and options.
- nl 8y agoI'm an engineer and I like Confluence, especially compared to any other options. And doubly compared to markdown (although I concede I'm probably the only engineer who dislikes markdown)
- wting 8y agoHow do non-engineers update documentation?
- sumedh 8y ago> Confluence which lead to out dated, subpar and incomplete documentation. How exactly is it Confluence's fault if your team does not update the docs?
- spudlyo 8y agoConfluence's editor is truly awful. I've spent 15 minutes just trying to remove superfluous newlines -- it's maddening. If you do something like {{fsck}} to create a bit of monospace text, it's totally unclear if there is a space after the text, or there isn't, due to the way the reverse video section is larger than the actual text. God help you if you accidentally backspace into the monospace section, everything you type after that is monospace. It's extremely frustrating. I wouldn't be surprised to learn that many folks when faced with the prospect of updating a document using the Confluence editor will instead just find something less terrible to do. I often write my entire document first using the old style Confluence markdown, and when done I import it into a new Confluence page. You can't take an existing document and convert into markdown, but if you are the only person working on the document this is a workable approach.
- sumedh 8y ago> I've spent 15 minutes just trying to remove superfluous newlines I find that hard to believe but have reported it to Atlassian? If all the problems which have mentioned are true why not move to something else?
- daturkel 8y agoI don't care for Confluence at all. It feels engineered to death (as does Jira, for that matter)—it can do everything, but nothing well. I've been trying to organize my team's Confluence space but I'm constantly confused by the software which seems to be working against me. I think my issue with Atlassian software is that it feels so unopinionated—they've added every option and customization because they have such a large enterprise customer base with unique needs—and the result is that it becomes byzantine and unfriendly because it can do _everything_.
- tommoor 8y agoWe've been working on an open source solution for this, if you're interested - markdown or wysiwygy based editing with a hosted option – http://getoutline.com/ http://getoutline.com/
- itomato 8y agoHow do I write macros? What advanced styling options are there? How do I manage templates? How do I restrict access to certain content?