]> git.proxmox.com Git - mirror_lxc.git/commit
CODING_STYLE: Update section header format
authorTobin C. Harding <me@tobin.cc>
Fri, 17 Aug 2018 04:40:45 +0000 (14:40 +1000)
committerTobin C. Harding <me@tobin.cc>
Fri, 17 Aug 2018 04:54:35 +0000 (14:54 +1000)
commit7419c83f441b61061f3056f4453b8ddefccef764
tree189685bb43dc53371df5b98fd026290e4c904e01
parentefcb7f361beefbdb1c24ad86c75c2ed468f29c90
CODING_STYLE: Update section header format

Currently for section headings we use fourth level markdown heading
level (####).  We do not have levels two or three.

We can use standard incremental levels for heading adornments i.e

1) =========
2) ##
3) ###
ect.

Since this document is likely referenced by maintainers when guiding new
contributors it can save maintainer time to be able to quickly reference
a section in the coding stlye guide.  If we add numbers to each heading
(like the kernel stlye guide) then maintainers can say:

   Nice patch, please see section 3 of the coding style guide and ...

So, this patch makes two changes

- Use incremental level heading adornments
- Add a number to each section heading

Signed-off-by: Tobin C. Harding <me@tobin.cc>
CODING_STYLE.md