We recently bought new wiki software, and there's no way to import from the old to the new, so we'll need to re-create our documentation. Never been 100% happy with our current front page or wiki structure, so I'm curious what sorts of things other folks do.
Also, to whom do you give access to read your wiki pages? (Obviously, read-write is kept within the confines of the team.)
At the moment, we have a tree of links on our front page. Our main branches are:
- $COMPANY network
- NOC team (really just a list of provider contacts and portals)
- Services we provide (we are an ISP, so Internet / MPLS / Managed Hardware / etc)
- Processes and Procedures
- Core devices we manage
- Servers
- Web Portals (mostly a restatement of bullet point #2)
- "Documentation" (config snippets, technical descriptions of products, other administrivia)
- Other Service Providers
- Customers (mostly customer-specific configs)
- Code and Programs we've written
- Security issues and vulnerabilities
- Processes internal to $COMPANY (mostly a repeat of bullet item #4)
- Products we support
- Technical Details (lists of our IP blocks, ASNs, etc)
- Hardware configurations (more complete than the "Documentation" link)
- Troubleshooting knowledge base
To me, the current wiki is a confusing mess of links, and to be honest I only use the search function. I don't ever try to navigate it.
TIA for any replies!
No comments:
Post a Comment