this post was submitted on 17 Jun 2023
4 points (100.0% liked)

Sysadmin

240 readers
2 users here now

A community dedicated to the profession of IT Systems Administration

founded 5 years ago
MODERATORS
 

Hi, all!

For those of you who work in organizations that do decent documentation, what are you using?

We currently just have a bunch of word docs in a SharePoint document library. I've previously used dedicated solutions for this such as Bookstack and Confluence. The company is very anti-Atlassian, so Confluence is out.

Just want to see what y'all are using as I search for a better solution.

Thanks!

top 11 comments
sorted by: hot top controversial new old
[–] bladewdr@infosec.pub 2 points 1 year ago (1 children)

I recently migrated all our various Excel and Word documents from Sharepoint into a self-hosted Bookstack instance. I love it.

I have one shelf for stuff like SOP, contracts, etc, and another for customer documentation.

[–] kalipike@lemmy.one 1 points 1 year ago

Thanks for sharing! I'm very tempted to give Bookstack a go.

[–] mythnubb@vlemmy.net 2 points 1 year ago (2 children)

Not using it, but Bookstack looked real nice for a documentation site.

We're using a different wiki at the moment for it.

[–] sdelling 2 points 1 year ago

We’ve been migrating a lot of documentation into Bookstack this year, and like it a lot so far.

[–] kalipike@lemmy.one 2 points 1 year ago

I had Bookstack at a previous org and really liked it, just nobody cared about it.

[–] bamboo 1 points 1 year ago

What are you using for bug tracking? IMO, the two should be hand in hand. If you're using GitHub issues, then GitHub wiki would make sense to me.

I've never had good luck using SharePoint or Google Docs for documentation, it just gets lost. If you're searching GitHub for an issue, it's easy to expand the search to include wiki. Having documentation in a separate system means searching two places, which is not ideal.

[–] Nath@aussie.zone 0 points 1 year ago (1 children)

Documentation? What's that?

[–] kalipike@lemmy.one 1 points 1 year ago

Haha that would be most the people on our team's response for sure.

[–] fourstepper@lemmy.ml 0 points 1 year ago (1 children)

For technical documentation, most of our teams are currently using Gitlab pages, however we are steadily moving to Backstage

[–] StaticFlow@feddit.uk 1 points 1 year ago

How is backstage? I look at it and feel perhaps we should just be using all the features of gitlab. Does it really bring something better to the table?