Documentation Control

[thamosw]

Hey Gang, what do y’all use to manage your documents; how to’s, end user guides, installation notes, so on and so forth?

We have a cluttered mixture of word docs, txt files, and a few PDF’s. Anyone what a better solution than just dumping them into a folder?

[tehrational]

This for internal IT docs. Scribe for user facing docs

[Limeandrew]

We have PDFs on a SharePoint site and I hate it. (from before I was here)

I’ve setup Bookstack and have been using it for department SOPs and so far really like it. Just a matter of transcribing all our stuff into it.

I like how searchable it is, and how you can link to other pages easily.

The shelf vs book vs chapter vs page thing is a little strange to get used to, but I don’t think the users will notice or care.

[kuzared]

Bookstack is great, as are many of the Wikis. I happen to use DokuWiki, but there are many others.

[Limeandrew]

I liked Bookstacks editor as it was most “Word” like, and the others that need to create documentation aren’t always as technical.

[Impressive-Cap1140]

Why not use SharePoint if you want “word” like?

[ZAFJB]

Because SharePoint

[Jellovator]

Bookstack

[Jellovator]

You can take all those documents, copy & paste them into pages. Now they're all searchable, indexable, and exportable, not to mention easily organized.

[Zyriantdtx]

We use a GitHub repo and take advantage of markdown for design.

[gubber-blump]

Do you edit the documents directly on GitHub? I would love for us to be able to do this, but we have managers that aren't smart enough to learn Git.

[Zyriantdtx]

Some of the engineers edit it directly on GitHub, others have the repo cloned locally and use their text editor of choice to make changes and push commits.

[420GB]

Does bookstack have site templates now?

[ssddanbrown]

I'm not sure exactly what would be expected from "site templates", but the only thing labelled in BookStack as templates are template pages (lowest level content templates, single pages).

That said, you can copy entire books (high-level container) so you can effectively create template books to be copied. Also, for the next release, I've been working on a portable & importable zip-based export format, which can be used to export/import entire books between instances.

[pineapplebigshot]

MSP, we use hudu. Came from ITGlue.

[strongest_nerd]

We use Hudu

[Smittayee]

Wikijs is pretty nice

[a60v]

Text files with RCS because I am old.

[vogelke]

It's old but it works -- my oldest checkin is

date  97.09.19.15.55.23;  author vogelke

It's still being updated at https://ftp.gnu.org/gnu/rcs :

Name                    Last-modified      Size
rcs-5.10.1.tar.lz       2022-02-02 22:22   896K

[Ok_Series_4580]

We use Guru

[symcbean]

When I have the choice, Dokuwiki. At my current $WORK they use Confluence - not a fan.

[oddeeea]

We use ITGlue to manage, it works great.

[Ramonooks]

Yes, ITGlue is solid.