Re: [PATCH 06/31] cgroup-v2.txt: standardize document format
From: Tejun Heo
Date: Fri May 19 2017 - 10:59:37 EST
Hello, Mauro.
On Thu, May 18, 2017 at 10:22:11PM -0300, Mauro Carvalho Chehab wrote:
> Each text file under Documentation follows a different
> format. Some doesn't even have titles!
>
> Change its representation to follow the adopted standard,
> using ReST markups for it to be parseable by Sphinx:
>
> - Comment the internal index;
> - Use :Date: and :Author: for authorship;
> - Mark titles;
> - Mark literal blocks;
> - Adjust witespaces;
> - Mark notes;
> - Use table notation for the existing tables.
If this is the direction we're taking for all docs, looks good to me.
Do you want me to take the patch through the cgroup tree?
Thanks.
--
tejun