User story #1673
closed
Be able to hide section in the output
Description
We are starting to think to some document items that will have to be cover in the long term. It would be great if we were able to say that some part are of the documentation are "draft" (or even just notes about topic) and that these part should be ignored for now.
Conditional include of external files may play the same role, even if that would be heavier to use (especially for small notes).
Updated by Fabrice FLORE-THÉBAULT about 13 years ago
maybe use branch/merge features of git for that purpose ?
(i have never used it extensively, but have heard only success stories about that)
Updated by Fabrice FLORE-THÉBAULT about 13 years ago
- Status changed from New to Discussion
- Target version set to 10
Maybe the best solution :
The content is a collection of .txt files, ordered into directories.
During the build of the documentation, a script is generating the actuel collection of .txt file to be included in the documentation, that is: which files, and in what order.
It will be really easy to tag some of these files so that the script will ignore them, or add them only under certain circumstances.
I see several ways to achieve this :
- symbolic links : files are created in some "fake" hierarchy, and then included into the actual hierarchy (same as sites-enabled for apache2 in Debian). Advantages : as many "actual hierachy" as needed. Drawbacks : maintenance issues expected.
- tags in name : add a "WIP" suffix to the files which are not ready. Advantages: keep it simple. Drawbacks : too much tags will kill the tags...
Updated by François ARMAND about 13 years ago
- Target version changed from 10 to 24
Updated by Jonathan CLARKE over 12 years ago
- Target version changed from 24 to Ideas (not version specific)
Updated by Benoît PECCATTE over 9 years ago
- Project changed from 30 to Rudder
- Category set to Documentation
Updated by Benoît PECCATTE over 7 years ago
- Status changed from Discussion to Rejected
This ticket is meaningless.
We have PR for unfinished documentation.
We have merge for finished documentation.