Ranter
Join devRant
Do all the things like
++ or -- rants, post your own rants, comment on others' rants and build your customized dev avatar
Sign Up
Pipeless API
From the creators of devRant, Pipeless lets you power real-time personalized recommendations and activity feeds using a simple API
Learn More
Comments
-
C0D4681385yBecause they are also using Jira to track change requests with a broader team whom may or may not have access to the codebase.
-
@C0D4 ehhr we do use Jira, but the ones we are documenting (and the stuff we are documenting) is only required by our team - and all of us have access to Confluence. I don't agree in that reason for this case.
-
@Codex404 now, more seriously https://atlassian.com/software/...
it's like a WordPress for documentation, but annoyingly slow -
C0D4681385y@elvieeejo speaking from personal experience, each company seems to do it differently.
-
@elvieeejo I think the term you search for is "wiki".
---
In combination with Jira, it works quite well - especially for a project not purely out of code and for non-dev customers (e.g. reference tickets<->wiki pages, customers, etc.). As the hole company uses it, nobody needs to teach the HR markdown.
Downsides are the high prize of Jira/Confluence, the slow speed and the many security vulnerabilities that have to be patched. -
@sbiewald I agree with you, even with the downsides (I hate how slow it is)
it's strange when its used by technical people for technical stuff, for example, commands for a deploy or setup. -
@elvieeejo I guess the intention is to not have documentation at two different places?
-
@sbiewald could be, but I usually prefer to have docs close to where should be used it, at least for technical ones. Like, tech.commands for setting up a repo or deploying it, being the docs in the repo
Related Rants
Considering that Markdown exists and Readme files are rendered by default in GitLab, Github, and so on
Why devs insist on documenting stuff on Confluence?
question
gitlab
markdown
confluence
github
documentation
git
project managers