Project

General

Profile

Actions
Copy link

User story #6604

closed

Split the html documentation to improve readability and navigability

Added by Alexis Mousset over 9 years ago. Updated almost 9 years ago.

Status:
Released
Priority:
N/A
Assignee:
Jonathan CLARKE
Category:
Documentation
Target version:
2.10.17
Pull Request:
https://github.com/Normation/rudder-d...
UX impact:
Suggestion strength:
User visibility:
Effort required:
Name check:
Fix check:
Regression:

Description

The current html manual is a very long web page in which it may be difficult to find your way, especially because the left menu requires a lot of scrolling.

We could use the docbook webhelp output format, which would not require any modifications of the source files. It is for example used by OpenStack and neo4j.

Files

Download all files
Screenshot from 2015-08-17 10-59-34.png (167 KB) Screenshot from 2015-08-17 10-59-34.png screenshot Alexis Mousset, 2015-08-17 12:01
Screenshot from 2015-08-17 16-33-38.png (245 KB) Screenshot from 2015-08-17 16-33-38.png screenshot Alexis Mousset, 2015-08-17 16:34

Subtasks 5 (0 open — 5 closed)

User story #7112: Add indexation to enable searchReleasedJonathan CLARKE2015-08-18Actions
User story #7115: Fix favicon linkReleasedJonathan CLARKE2015-08-19Actions
User story #7117: Use the webhelp doc as embedded doc in the webappReleasedJonathan CLARKE2015-11-23Actions
Bug #7437: Embedded docs don't display the correct index.html fileReleasedBenoît PECCATTE2015-11-23Actions
User story #7120: Remove uneeded and un-existent file from webhelp cssReleasedJonathan CLARKE2015-08-19Actions
Actions
Copy link

Also available in: Atom PDF