Cleanup wiki

Testing RSpec
1

The wiki (especially the index on its right hand)
http://wiki.github.com/dchelimsky/rspec/
currently (to me) feels a bit hard to navigate.

Given that my one request to github to allow for orderable right hand
index was denied, I was wondering if some work wants to be done on it
to make it easier to navigate.

Two options seem to present themselves:

  1. rename each page with an “ordering” prefix, like

1 Getting Started
1.1 Installation
1.1.2 Rails
1.2 Troubleshooting
2 Developing
2.1 Contributing
2.2 Getting in touch

etc.

advantage: the right hand index looks good, looks organized, overall
easier to use.
disadvantage: harder to edit, since ordering matters.

  1. Add an “A Table of contents” page (it will be at the top), similar
    to http://wiki.github.com/aslakhellesoy/cucumber/a-table-of-content
    advantage: easier to edit.
    disadvantage: right hand index looks ugly.

Any thoughts in this regard?
-rp
Any thoughts there?

2

On Fri, Jun 11, 2010 at 1:49 PM, rogerdpack [email protected]
wrote:

advantage: the right hand index looks good, looks organized, overall
Any thoughts there?
I think a TOC would be far easier to maintain, no?

3

I think a TOC would be far easier to maintain, no?

I think so. I’ll create one sometime.