User story #1673

Be able to hide section in the output

Added by François ARMAND about 6 years ago. Updated 8 months ago.

Target version (plugin):
Suggestion strength:
User visibility:
Effort required:
Pull Request:


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).


#1 Updated by Fabrice FLORE-THÉBAULT about 6 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)

#2 Updated by Fabrice FLORE-THÉBAULT about 6 years ago

  • Status changed from New to Discussion
  • Target version set to Ideas (2.3 specific)

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...

#3 Updated by François ARMAND about 6 years ago

  • Target version changed from Ideas (2.3 specific) to 24

#4 Updated by Jonathan CLARKE over 5 years ago

  • Target version changed from 24 to Ideas (not version specific)

#5 Updated by Benoît PECCATTE over 2 years ago

  • Project changed from Rudder-Doc to Rudder
  • Category set to Documentation

#6 Updated by Benoît PECCATTE 8 months ago

  • Status changed from Discussion to Rejected

This ticket is meaningless.
We have PR for unfinished documentation.
We have merge for finished documentation.

Also available in: Atom PDF