Some time ago I was researching to find a good tool to create and manage IT documentation at work. These are the features that were essential for me:
- Editor Wysiwyg (not directly in markup language)
- Paste images directly (instead of first uploading it to insert it in the document).
- Team work: Full role and permission system. In case with LDAP integration much better.
Among all the solutions that I tried, without a doubt, one of them stood out …
- 1 Bookstack
- 2 Features
- 3 Conclusion
Bookstack (https://www.bookstackapp.com/) is a free and self-hosted wiki solution with mutiple features. Super easy way to manage the documentation so its not lazy to keep it updated.
Very simple and easy to use interface in which the content is created in pages, chapters, books and shelves.
Personally, I have installed two different bookstack instances:
- Apache (Linux Debian) + MySQL (Linux Debian)
- IIS (Windows) + MySQL (Linux Debian)
As long as you use PHP and MySQL, the requirements can be met with different systems.
Role permission management
To allow team work, Bookstack offers good permission options and granularity, to grant create, view, edit or delete permissions on books, pages, chapters, images, shelves…
As reflected in the Bookstack documentation:
“BookStack can be configured to allow LDAP based user login. While LDAP login is enabled you cannot log in with the standard user/password login and new user registration is disabled. BookStack will only use the LDAP server for getting user details and for authentication. Data on the LDAP server is not currently editable through BookStack.”
So, LDAP users can be used to login and LDAP groups to grant Bookstack roles to those users.
Link URLs to pages or page sections can be created as well as tags to copy entire pages or page sections.
Page revisions / Automatic drafts saving
As I have shown, Bookstack is a simple but at the same time very complete wiki tool with a lot of very useful features. In my work its being used more and more and I completely recommend it for IT or any other type of documentation.