[rspec-users] cleanup wiki

David Chelimsky dchelimsky at gmail.com
Sat Jun 12 06:33:28 EDT 2010


On Fri, Jun 11, 2010 at 1:49 PM, rogerdpack <rogerpack2005 at gmail.com> wrote:
> 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.
>
> 2) 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?

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


More information about the rspec-users mailing list