Technical Documentation
-
@aaronstuder said:
@coliver said:
It is so easy to install doku or mediawiki that I don't think I would go turnkey.
Which one would you use? or What would you be leaning towards?
This is for public docs, and private docs so I need some control over who can see what.
I've only ever stood up a MediaWIki server. Dokuwiki looks to be easier to implement. Both can do authentication and authorization. So you wouldn't have any issues locking down certain areas.
-
@Dashrender said:
@aaronstuder said:
A wiki does seem much simpler
But formatting sucks!
Really? I've never noticed an issue with formatting. Mediawiki has some plugins that have better WYSIWYG editors but the default one and the syntax are pretty quick the learn.
-
@coliver said:
@Dashrender said:
@aaronstuder said:
A wiki does seem much simpler
But formatting sucks!
Really? I've never noticed an issue with formatting. Mediawiki has some plugins that have better WYSIWYG editors but the default one and the syntax are pretty quick the learn.
having to type '<br>' everywhere to get a carriage return is a huge PITA.
-
Confluence is nice. The editor is easy to use they do have a strange permissions system that doesn't always work the greatest, but there is a huge overhead in both resources and licensing when you compare to other options.
-
@Dashrender said:
@coliver said:
@Dashrender said:
@aaronstuder said:
A wiki does seem much simpler
But formatting sucks!
Really? I've never noticed an issue with formatting. Mediawiki has some plugins that have better WYSIWYG editors but the default one and the syntax are pretty quick the learn.
having to type '<br>' everywhere to get a carriage return is a huge PITA.
In Mediawiki? Just hit return twice.
-
I'll stand one up tonight or tomorrow..
try again. -
http://www.wikimatrix.org/compare/dokuwiki+mediawiki
duku seems like the clear winner here...
-
@Dashrender said:
I'll stand one up tonight or tomorrow..
try again. -
@coliver said:
@Dashrender said:
I'll stand one up tonight or tomorrow..
try again.Can you limit access to this?
-
@wirestyle22 said:
@coliver said:
@Dashrender said:
I'll stand one up tonight or tomorrow..
try again.Can you limit access to this?
I'm not sure what you mean?
-
@coliver said:
@wirestyle22 said:
@coliver said:
@Dashrender said:
I'll stand one up tonight or tomorrow..
try again.Can you limit access to this?
I'm not sure what you mean?
It's a website correct? What if your documentation are instructions and have sensitive information like IP addresses for remote access etc? I would need to limit access.
-
@wirestyle22 said:
@coliver said:
@wirestyle22 said:
@coliver said:
@Dashrender said:
I'll stand one up tonight or tomorrow..
try again.Can you limit access to this?
I'm not sure what you mean?
It's a website correct? What if your documentation are instructions and have sensitive information like IP addresses for remote access etc?
Both MediaWiki and DokuWiki can require authentication for some pages and other pages be completely public.
-
@coliver said:
@wirestyle22 said:
@coliver said:
@wirestyle22 said:
@coliver said:
@Dashrender said:
I'll stand one up tonight or tomorrow..
try again.Can you limit access to this?
I'm not sure what you mean?
It's a website correct? What if your documentation are instructions and have sensitive information like IP addresses for remote access etc?
Both MediaWiki and DokuWiki can require authentication for some pages and other pages be completely public.
That is fantastic. Thank you very much for the recommendation. Very helpful.
-
The nice thing about dokuwiki is that it uses just text files. No backend database or anything like that.
-
@coliver said:
The nice thing about dokuwiki is that it uses just text files. No backend database or anything like that.
Yes that is also great. I will definitely be using this in the near future.
-
Anyone know of a good CentOS 7 install guide for dokuwiki?
-
The biggest problem I am seeing with the Wiki is no categorization.
-
@aaronstuder said:
The biggest problem I am seeing with the Wiki is no categorization.
Give me an example please.
-
@Dashrender I want to categorize my articles by topic: (printing, blackberry, etc.)
-
Interesting - there might be tags like there are here in ML. Otherwise the search function is your friend.
In my case I'll end up making Table of Contents pages that will link to other pages talking about the topic linked.
Think about an employee handbook. There will be a TOC, and it will have links to each section of the handbook.
You could do the same, create pages of links for Printing, Blackberry, etc - as you create a new article/page you'll create a link to those on the (we'll call them) main pages.
Then on the homepage to the wiki, you can have links to this main pages.
