- changed status to open
- assigned issue to
- removed comment
Documentation page should be better organised
The documentation page of the Cactus website,
http://cactuscode.org/documentation/
currently consists of a main body of text and a sidebar on the right. The main body contains links to the PDF versions of some of the documentation, and the sidebar contains links to other pieces of documentation, some but not all of which are in the main body as well.
I propose that the sidebar is redundant, and not going to be noticed by most people as it is a sidebar, and should be removed. The documentation that is linked to from the sidebar should be linked to from the main part of the page, and the links should be to the HTML versions of the documentation. We could also provide links to the PDF versions as well, if anyone likes them.
We could also be more descriptive about what each piece of documentation is. For example, indicating which document new users should start with (User's Guide).
Keyword: documentation
Comments (6)
-
-
- removed comment
I consolidated the links on the side bar and those in the main page. I also wrote paragraphs describing each link. I have yet to link to HTML pages, but am working on it.
-
- removed comment
I linked to the HTML versions of the User's Guide and the Reference Manual.
-
reporter - removed comment
Unfortunately, when I try to follow the links on the documentation page, I now get a 404 Not Found error. For example, the first PDF link to the Users Guide is
http://cactuscode.org/documentation/userguide/UsersGuide.pdf
but this gives a 404.
-
reporter - marked as critical
- removed comment
Raising priority of this ticket as the main Cactus documentation on the website is no longer working.
-
reporter - changed status to resolved
- removed comment
All working now, and the reorganised page looks great! Thanks!
- Log in to comment