Take the 2-minute tour ×
WordPress Development Stack Exchange is a question and answer site for WordPress developers and administrators. It's 100% free, no registration required.

We'd like to use WordPress to author the technical documentation for our software product. We've used plain-old WordPress pages, arranged then hierarchically, and it works ok, but it's not great. The problems:

  • The Wordpress page editor is dog slow.
  • You can't drag and drop pages around to change the hierarchy
  • Nothing maintains section numbering, like section 1.1, 1.2, 1.2.3.
  • I haven't found a way to build an automatically-created table of contents on the right hand side.
  • I'd like to have a tag to highlight and indent code.

I could probably assemble a collection of plugins to do all these things, but we've already put a fair amount of time into that, and still don't have a great solution.

Confluence would be a good way to go, but I'd like to keep everything in Wordpress.

Any suggestions for good technical documentation plugins?

share|improve this question
add comment

closed as off topic by toscho Nov 5 '12 at 3:33

Questions on WordPress Development Stack Exchange are expected to relate to WordPress within the scope defined by the community. Consider editing the question or leaving comments for improvement if you believe the question can be reworded to fit within the scope. Read more about reopening questions here.If this question can be reworded to fit the rules in the help center, please edit the question.

3 Answers

up vote 5 down vote accepted

You're going to have to go with some plugins.

The Wordpress page editor is dog slow.

Throw more resources at it and/or disable some functions from showing under the "Screen Options" tab. It should not really be slow unless your have a ton of people working on a ton of pages at same time, if you can clarify what/why it is slow.

You can't drag and drop pages around to change the hierarchy

You will need a plugin for this , like http://wordpress.org/extend/plugins/simple-page-ordering/

Nothing maintains section numbering, like section 1.1, 1.2, 1.2.3.

You have two options here, create a custom field meta box called " Sections" and enter a number for the value on each page, this is simple to query and display, but does not have any built in hierarchy. Option 2 would be to use categories ( or a custom taxonomy) for pages, and have them as a hierarchy ( this also allows for easier slugs), or just use a CPT.

I haven't found a way to build an automatically-created table of contents on the right hand side.

There are various plugins for this, search wordpress.org for "TOC". Or if you use the methods mentioned above you can use some built in WordPress functions ( esp if you create a section taxonomy).

I'd like to have a tag to highlight and indent code.

I like this one, http://wordpress.org/extend/plugins/syntaxhighlighter/, but there are others that are good on .org.

share|improve this answer
add comment

I use WordPress for documentation. I use the following plugins

For table of contents on the right of the pages, I use a plugin named 'table of contents plus.' I use a short code [toc] to insert a TOC in pages.

For ordering pages hierarchically, I use a plugin named 'CMS page tree view.' This allows you to drag and drop pages or group of pages around.

Mine was a changeover from Robohelp to WordPress, and I needed a page navigation tree on the lef side bar. I use a plugin named 'wp-page tree' for this.

share|improve this answer
add comment

You could try this plugin called Table of content.

share|improve this answer
1  
Without a link this is not an answer. –  toscho Dec 14 '11 at 13:05
add comment

Not the answer you're looking for? Browse other questions tagged or ask your own question.