Ideas for ITSP and MSP Internal and Customer Documentation
-
Btw for anyone interested, I have used Boostnote a lot for code notes. It works great if you have a lot of that to document. I'll leave it up to you to decide to use that over something like Github or Gitlab though. So just mentioning it for anyone that might want something like that.
-
@jmoore said in Ideas for ITSP and MSP Internal and Customer Documentation:
I know this topic is quite old so my apologies. Whatever came of this though? I am looking for something at work to improve what we have, which is not really much. We use text files, word files, and spreadsheets for example and we need to do much better.
Wow, this has been a while. I'll try my best to update. And I'm not saying where we are is great, but it is a massive improvement and we are pretty happy. We've looked at, and we keep looking at, BookStack, but I think that we've decided that it just isn't quite right for us. We do manage and use BookStack for a partner, though (and @valentina has been doing little else for weeks, she is doing full time BookStack management and is about to do the same for DokuWiki) and know it pretty well at this point.
Here is where we are today:
- wiki.js for our main documentation
- NextCloud + Collabora (LibreOffice) for secondary documentation
- Open Document formats
-
wiki.js is really close to a 2.0 release. I'd test now, but not implement until they update. They are moving to a completely different database engine.
-
@scottalanmiller Ok thanks. I was searching and this topic is what came up for me on google so that is only reason I posted to such an old topic.
We are currently not using any kind of official documentation except excel, text, and word. It may not happen but i want to keep pushing to get us on something better than that.
-
@scottalanmiller What db were they on and what are they moving to out of curiosity?
-
@jmoore said in Ideas for ITSP and MSP Internal and Customer Documentation:
@scottalanmiller What db were they on and what are they moving to out of curiosity?
MongoDB and moving to PostgreSQL
-
@scottalanmiller Ok interesting.
-
@jmoore said in Ideas for ITSP and MSP Internal and Customer Documentation:
@scottalanmiller Ok interesting.
It is ONLY for authentication and sessions, not content. So makes way more sense. Totally terrible use case for MongoDB.
-
@scottalanmiller said in Ideas for ITSP and MSP Internal and Customer Documentation:
@jmoore said in Ideas for ITSP and MSP Internal and Customer Documentation:
@scottalanmiller Ok interesting.
It is ONLY for authentication and sessions, not content. So makes way more sense. Totally terrible use case for MongoDB.
So MongoDB will still be used for content?
-
@wrx7m said in Ideas for ITSP and MSP Internal and Customer Documentation:
@scottalanmiller said in Ideas for ITSP and MSP Internal and Customer Documentation:
@jmoore said in Ideas for ITSP and MSP Internal and Customer Documentation:
@scottalanmiller Ok interesting.
It is ONLY for authentication and sessions, not content. So makes way more sense. Totally terrible use case for MongoDB.
So MongoDB will still be used for content?
No, it never was.
-
@JaredBusch Oh. OK. What is it then?
-
@wrx7m said in Ideas for ITSP and MSP Internal and Customer Documentation:
@JaredBusch Oh. OK. What is it then?
Authentication.
-
@scottalanmiller What does it use for content?
-
@wrx7m said in Ideas for ITSP and MSP Internal and Customer Documentation:
@scottalanmiller What does it use for content?
Just the file system. No database.
-
It is by doing that (the same as Dokuwiki does) that it is able to use GIT as a backup mechanism and version control.
-
@scottalanmiller said in Ideas for ITSP and MSP Internal and Customer Documentation:
It is by doing that (the same as Dokuwiki does) that it is able to use GIT as a backup mechanism and version control.
By far the best thing I like about wiki.js
-
@black3dynamite said in Ideas for ITSP and MSP Internal and Customer Documentation:
@scottalanmiller said in Ideas for ITSP and MSP Internal and Customer Documentation:
It is by doing that (the same as Dokuwiki does) that it is able to use GIT as a backup mechanism and version control.
By far the best thing I like about wiki.js
You can do this with DokuWiki too, it just isn't automated as part of the install.
-
@scottalanmiller said in Ideas for ITSP and MSP Internal and Customer Documentation:
@black3dynamite said in Ideas for ITSP and MSP Internal and Customer Documentation:
@scottalanmiller said in Ideas for ITSP and MSP Internal and Customer Documentation:
It is by doing that (the same as Dokuwiki does) that it is able to use GIT as a backup mechanism and version control.
By far the best thing I like about wiki.js
You can do this with DokuWiki too, it just isn't automated as part of the install.
That’s a plus me.
-
Didn't have time to mess with anything last night because of family. Hopefully tonight. I'm excited to try Wiki.js and Bookstack
-
@jmoore said in Ideas for ITSP and MSP Internal and Customer Documentation:
Didn't have time to mess with anything last night because of family. Hopefully tonight. I'm excited to try Wiki.js and Bookstack
If I was turning up something for only IT, and had the authority to force people to use it, I would only use Wiki.js. I totally love the git based backup thing.
