symfony/symfony-docs — pull request #2481 by WouterJ (2013-04-07 21:55:29+00:00)
Title: Refactored Doc standards

| Q | A
| ------------- | ---
| Doc fix? | yes
| New docs? | yes
| Applies to | all
| Fixed tickets | -

I spoke the CMF guys (mainly @dbu ) this weekend and they are going to follow our documentation standards. Now it's used in more project, I've moved it outside the overview document and inside it's own document.

There are also some other things which needs some discussion (things that are added in this PR are things that I and the CMF guys like to see in the standards, but if people are -1 for it, it gets removed):

- Added standards on which characters to use for heading levels - *Sphinx doesn't have specific level specific character, they should be documented somewhere*
- Added a standard about inline hyperlinks vs the once we use
- Added standards about the needed formats - *Without this, all @ricardclau's and my work needs to get done again* :wink: