We are using the Johnny.Decimal system for our internal documentation and file storage, and I just finished deploying Forgejo on our server and setting up Git versioning, and it’s absolutely awesome and I just had to share. We use JDex as a wiki, either pointing to files kept in the file structure in our Nextcloud share, pointing to external tools, or mostly we write policies and procedures in the JDex itself.
In Obsidian, we are using the Obsidian Git plugin. I created a repo called sasquatchnetworks/documentation, and after pushing the original copy, all of our employees can pull the latest version of the documentation(which is really just our JDex). Install Obsidian, install the plugin, run the pull command, and they’re good to go.
This gives us some amazing features:
- JDex can be pulled on any device - even the Obsidian mobile app we can sync with the Git plugin. You could pull on a Linux machine and view it in terminal if you had to.
- Git plugin auto pulls on Obsidian startup so their local copy is always up to date.
- Only admins have permission to push new documentation, so regular employees effectively have a read-only version - they can pull but not push.
- We have an automation that notifies in Slack when an admin has changed a file and pushed a commit, notifying the team when documentation is updated and what was changed
- Team members can open an Issue on our Forgejo if they encounter a policy conflict, bad documentation, or broken link
- Team members can fork our documentation, make edits of their own, and file a pull request to merge with the main branch, so admins can review their suggested changes and deny or merge. (We don’t really expect anyone to bother - they’ll probably just ping an admin in Slack)
- Forgejo supports our SSO solution so a team member’s SSO account ultimately gets them into our documentation/JDex
It’s an awesome solution that gives us precise version control and changelogs on every scrap of documentation and JDex entry, and for our team, that’s absolutely invaluable. Maybe this is overkill for a personal setup, but for a shared JDex this could make a world of difference for you.