nanog mailing list archives
Re: WIKI documentation Software?
From: Karl Auer <kauer () biplane com au>
Date: Sun, 15 Mar 2020 00:23:41 +1100
On Sat, 2020-03-14 at 08:07 -0400, Craig wrote:
Wanted to ask what WIKI software teams are using to save documentation to / how to's for staff, etc.
Like any other software, make a set of requirements and then go looking. The order of those two steps is important, though you're allowed to iterate. Remember to match the requirements to the people who will actually be using the thing, not the people who will be managing it :-) Personally I think the plethora of formatting options in things like Confluence tends to distract people into spending vast amounts of time getting their pages to look just right, that would have been better spent capturing more actual information. Or it makes them avoid adding information because it's too hard, or it takes too long, or it invites odious comparisons with other people's entries. Regards, K. -- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Karl Auer (kauer () biplane com au) http://www.biplane.com.au/kauer http://twitter.com/kauer389 GPG fingerprint: 2561 E9EC D868 E73C 8AF1 49CF EE50 4B1D CCA1 5170 Old fingerprint: 8D08 9CAA 649A AFEF E862 062A 2E97 42D4 A2A0 616D
Current thread:
- WIKI documentation Software? Craig (Mar 14)
- Re: WIKI documentation Software? Josh Baird (Mar 14)
- Re: WIKI documentation Software? Gavin Henry (Mar 14)
- Re: WIKI documentation Software? Karl Auer (Mar 14)
- Re: WIKI documentation Software? Brielle (Mar 14)
- Re: WIKI documentation Software? Bill Woodcock (Mar 14)
- Re: WIKI documentation Software? Yang Yu (Mar 15)
- Re: WIKI documentation Software? Grimes, Greg (Mar 15)
- Re: WIKI documentation Software? Andrew Latham (Mar 15)
- Re: WIKI documentation Software? Brielle (Mar 14)
- Re: WIKI documentation Software? Eric Kuhnke (Mar 17)
- Re: WIKI documentation Software? Josh Baird (Mar 14)
- Re: WIKI documentation Software? Craig (Mar 14)
- RE: WIKI documentation Software? Ray Orsini (Mar 14)
- Re: WIKI documentation Software? Anurag Bhatia (Mar 14)