Technical Documentation
-
@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.
-
I'm the only person that ever references the documents, so I use an encrypted and password protected instance of TiddlyWiki. Super easy to update, maintain, and implement and no server required. It isn't ideal for all situations, but it works really well for me.
