Software used for documentation recommendations?
-
@Tim_G
Thanks! I'll definitely look into it.
-
I like using a wiki for this. DokuWiki is probably the easiest to really use, no database needed. We are using wiki.js currently ourselves. Needs a database though, and is going through a lot of change before its next release.
-
@fredtx said in Software used for documentation recommendations?:
I've been looking into One Note, but what to see what else is out there.
Also, OneNote is horrible for this. I'd not waste your time with it (for this purpose).
-
@tim_g said in Software used for documentation recommendations?:
I like to use WordPress with a wiki theme, and some plugins installed to make it super easy and efficient to create documentation.
Platform: WordPress
Theme: WikiWP
Plugins:- Members: allows granular user and role management
- OnePress Image Elevator: allows you to paste images / screenshots directly into the editor... huge time saver
- Responsive Lightbox: allows images or links that are clicked to 'pop out' and the background dims
- Table of Contents Plus: automatically creates a table of contents as you see in wiki websites
- TablePress: an excellent tables plugin... you can import Excel spreadsheets for example
- TinyMCE Advanced: adds a lot of visual editing options
- Disable Comments: as the name says
- Broken Link Checker: handy to make sure no links are broken
It's like working in MS Word or similar. Very easy and fast to document.
Yh I also use WP for Intranets. But you do mention interesting plugins.
-
@tim_g said in Software used for documentation recommendations?:
@fredtx said in Software used for documentation recommendations?:
I've been looking into One Note, but what to see what else is out there.
Also, OneNote is horrible for this. I'd not waste your time with it (for this purpose).
Same here. We tried it. Okay for a one man team. But terrible for collaboration.
-
Something on my to do list. I'm the same text files and images saved all over the place. Need to collect them all up into one system and easier to access and find
-
@tim_g said in Software used for documentation recommendations?:
If this will be available or reachable through the public internet, there are some additional things you must do.
If that is the case, and you decide on WP, let me know and I'll give you the few extra steps.
I'm interested in those extra steps needed!
-
@hobbit666 said in Software used for documentation recommendations?:
Something on my to do list. I'm the same text files and images saved all over the place. Need to collect them all up into one system and easier to access and find
This is where DokuWiki is perfect. Needs a web server and PHP, but nothing else. It handles storing your docs as just text files on the filesystem. So you can back them up with GIT or SVN or just copy them somewhere. You can keep your "just files" processes, but have an organized, hosted wiki, too.
-
@scottalanmiller said in Software used for documentation recommendations?:
@hobbit666 said in Software used for documentation recommendations?:
Something on my to do list. I'm the same text files and images saved all over the place. Need to collect them all up into one system and easier to access and find
This is where DokuWiki is perfect. Needs a web server and PHP, but nothing else.
Is there a particular web host service you recommend? Go daddy?
-
@fredtx said in Software used for documentation recommendations?:
@scottalanmiller said in Software used for documentation recommendations?:
@hobbit666 said in Software used for documentation recommendations?:
Something on my to do list. I'm the same text files and images saved all over the place. Need to collect them all up into one system and easier to access and find
This is where DokuWiki is perfect. Needs a web server and PHP, but nothing else.
Is there a particular web host service you recommend? Go daddy?
I use Dreamhost. It's been great the past year I've had it.
-
I've heard good things about Hostadillo. I'd switch, but I don't have time and I'm paid in advance.
-
@fredtx said in Software used for documentation recommendations?:
@scottalanmiller said in Software used for documentation recommendations?:
@hobbit666 said in Software used for documentation recommendations?:
Something on my to do list. I'm the same text files and images saved all over the place. Need to collect them all up into one system and easier to access and find
This is where DokuWiki is perfect. Needs a web server and PHP, but nothing else.
Is there a particular web host service you recommend? Go daddy?
Another vote for Hostadillo. Not only are they from Dallas.... but I run it
-
Thanks for the WIKIWP recommendation from @Tim_G
-
@dbeato said in Software used for documentation recommendations?:
Thanks for the WIKIWP recommendation from @Tim_G
There are demos of what WikiWP looks like too.
http://wikiwp.com/demo-wiki-page/
https://wikiwp.com/demo-wiki-post/ -
WikiWP is what I am leaning towards.
I have Wiki.js online and tested, but it is honestly too complicated (for my other users) because of the lack of a WYSIWYG style editing.
I tried to setup Grav, but it failed. Will try again later.
-
WIkiWP hasn't been updated since January 27, 2016. Compatibility issue can appear with a newer version of WordPress.
-
@black3dynamite said in Software used for documentation recommendations?:
WIkiWP hasn't been updated since January 27, 2016. Compatibility issue can appear with a newer version of WordPress.
Running fine on 4.9.4
-
@dbeato said in Software used for documentation recommendations?:
@black3dynamite said in Software used for documentation recommendations?:
WIkiWP hasn't been updated since January 27, 2016. Compatibility issue can appear with a newer version of WordPress.Running fine on 4.9.4
Works great for me too. But for how long? I normally stick with the defaults from Wordpress.
-
@black3dynamite said in Software used for documentation recommendations?:
@dbeato said in Software used for documentation recommendations?:
@black3dynamite said in Software used for documentation recommendations?:
WIkiWP hasn't been updated since January 27, 2016. Compatibility issue can appear with a newer version of WordPress.Running fine on 4.9.4
Works great for me too. But for how long? I normally stick with the defaults from Wordpress.
I get it so we will see.
-
@black3dynamite said in Software used for documentation recommendations?:
WIkiWP hasn't been updated since January 27, 2016. Compatibility issue can appear with a newer version of WordPress.
I started using it a long while ago when it was still current. I didn't realize they stopped maintaining it.
So because of that, I wouldn't recommend running it publicly or allow it to be publicly accessible.
There are a couple other wiki-based themes, but really, you can customize any theme to work well as a wiki.
Come to think of it, I may end up customizing a default theme (like 'Twenty Seventeen' for example) to look like WikiWP via CSS. This way there will be more long-term support.
