Project

General

Profile

Actions

User story #1673

closed

Be able to hide section in the output

Added by François ARMAND over 12 years ago. Updated about 7 years ago.

Status:
Rejected
Priority:
5
Assignee:
-
Category:
Documentation
UX impact:
Suggestion strength:
User visibility:
Effort required:
Name check:
Fix check:
Regression:

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

Actions #1

Updated by Fabrice FLORE-THÉBAULT over 12 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)

Actions #2

Updated by Fabrice FLORE-THÉBAULT over 12 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...

Actions #3

Updated by François ARMAND over 12 years ago

  • Target version changed from 10 to 24
Actions #4

Updated by Jonathan CLARKE almost 12 years ago

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

Updated by Benoît PECCATTE about 9 years ago

  • Project changed from 30 to Rudder
  • Category set to Documentation
Actions #6

Updated by Benoît PECCATTE about 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.

Actions

Also available in: Atom PDF