Re: NEWS file format

[Pascal B. <pj...@in...>]

> On 11 Jan 2018, at 23:02, Bruno Haible <br...@cl...> wrote:
> 
> Hi Sam,
> 
>> CLISP NEWS file is fairly long (almost 5k lines).
> 
> People usually will want to ignore the news from 2010 and before.
> So, that makes only ca. 200 lines to read.
> 
>> It has "free text" format.
>> I want to convert it to the outline format
>> (https://www.gnu.org/software/emacs/manual/html_node/emacs/Outline-Format.html)
>> which will allow for an easier navigation in Emacs and VIM.
> 
> Please not! I object!
> 
> Rationale:
> 
> 1) This outline format is ill-conceived for reading without special tool
>   support. Namely, the subsubsections stand out brighter than the sections.
>   (The subsubsections have 3 asterisks, vs. 1 asterisk for the sections.)
>   This is just the opposite of what it ought to be. Section titles should
>   stand out more heavily than subsubsections.

I agree.

The reStructured Text (rst) format is more adapted for both human reader and machine processing.
The various markdown formats are worse than reStructuredText.





-- 
__Pascal J. Bourguignon__