mirror of
https://github.com/jazzband/django-authority.git
synced 2026-03-16 22:20:28 +00:00
40 lines
897 B
Text
40 lines
897 B
Text
.. _documentation-guidelines:
|
|
|
|
.. warning:: This document is for internal use only.
|
|
|
|
========================
|
|
Documentation Guildlines
|
|
========================
|
|
|
|
Headline scheme
|
|
===============
|
|
::
|
|
|
|
===================================
|
|
First level (equals top and bottom)
|
|
===================================
|
|
|
|
Second Level (equals bottom)
|
|
============================
|
|
|
|
Third level (dashes botton)
|
|
---------------------------
|
|
|
|
Fourth level (drunken dashes bottom)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Please try to use not more than 4 levels of headlines.
|
|
|
|
Overall salutation guidelines
|
|
=============================
|
|
|
|
Use the *We* and *you*::
|
|
|
|
We think that you should send us a bottle of your local beer.
|
|
|
|
Some thoughts
|
|
=============
|
|
|
|
* Many internal links are good
|
|
* Text should not be wider than 80 characters
|
|
* Two pages are better than one ultra-long page
|