[VectorLock]

I've spent a lot of time thinking about how to unsuck Confluence but haven't come on anything really great. It doesn't help the WYSIWYG in-browser editor isn't great, and its document model/API doesn't exactly lend itself to getting documents in/out of it from other systems like Markdown, etc.

[imbnwa]

IIRC Confluence defines its own dialect of Markdown as well, but I don't think the issue is the tech so much as enforcing some minimum discipline in encoding knowledge formally in a central, organized repository. That takes building a culture which in turn takes investment from management to acquire as far as I can tell.

Until then, I'd rather have things decentralized in their appropriate Github/Gitlab repository with issues and a wiki. At least this way you have all functional blocks of knowledge absolutely in one place since you can get code history, closed issues, and the wiki history in one place. I'd even go a step further and have design/UI as a directory in the repo.

[hinkley]

There's some way to quote a markdown document stored in Bitbucket in a Confluence page. That's proved to be less of a pain than dealing with Confluence.

[VectorLock]

Confluence has a lot of ways to 'embed' other documents but they look like junk and aren't searchable.

[imbnwa]

Did not know that, my current shop is all-in on Atlassian so I'll have to check that out

[hinkley]

Looks like it's not out of the box, might be why you hadn't heard of it. Having trouble finding the name of the plugin.

ETA: Closest I seem to be able to get is this jira ticket: https://jira.atlassian.com/browse/CONFSERVER-27798

[phaemon]

Would like to know this too.