[TYPO3-typo3org] doc_core_tsconfig heading nesting

Ernesto Baschny [cron IT] ernst at cron-it.de
Thu May 4 12:04:02 CEST 2006


Hi,

the online doc_core_tsconfig document might be better to work with with
a different nesting in its headings. It is particularly annoying in the
online version [1], as there isn't separate pages for each chapter
(everything is under chapter "1"). Currently it looks like this:

    * 1. TSConfig
          o 1.1. Introduction
                + Page TSconfig / User TSconfig
                + Syntax
          o 1.2. User TSconfig
                + The "TSconfig" field
                + Verifying the final configuration
                + Overriding previously set options
                + Setting default User TSconfig
                + Top Level Objects
                + ->ADMPANEL
                + ->OPTIONS
                + ->SETUP
          o 1.3. Page TSconfig
                + The "TSconfig" field
                + Verifying the final configuration
                + Setting default Page TSconfig
                + Top Level Objects
                + ->MOD
                + ->TCEMAIN
                + ->TCEFORM
                + ->TSFE

Better would be:

    * 1. TSConfig
    * 2. Introduction
          o 2.1. Page TSconfig / User TSconfig
          o 2.2. Syntax
    * 3. User TSconfig
          o 3.1. The "TSconfig" field
          o 3.2. Verifying the final configuration
          o 3.3. Overriding previously set options
          ...
    * 4. Page TSconfig
          o 4.1. The "TSconfig" field
          o 4.2. Verifying the final configuration
          ...

which is what other documents do (Inside TYPO3, etc). The same "problem"
seems to occur in:

- TYPO3 Coding Guidelines
- TYPO3 Services

and probably a lot of other extensions.

Is this the right place to discuss this? Who would be responsible for
those documents?

Cheers,
Ernesto


[1]
http://typo3.org/documentation/document-library/references/doc_core_tsconfig/current/view/



More information about the TYPO3-team-typo3org mailing list