lkml.org 
[lkml]   [2019]   [Apr]   [23]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
    /
    Date
    From
    SubjectRe: [PATCH v2 38/79] docs: scheduler: convert docs to ReST and rename to *.rst

    * Peter Zijlstra <peterz@infradead.org> wrote:

    > On Tue, Apr 23, 2019 at 12:32:02PM +0200, Ingo Molnar wrote:
    >
    > > The .rst files still read like text files, right?
    >
    > Like a harder to read text file for no gains.

    I just looked through a couple of RST files in Documentation/, and they
    look like perfectly readable text files to me.

    Some of the formatting details are arguably 'special' and can be broken
    via "text edits" without being aware of the RST markup relevance - but I
    don't think it's a problem for RST-unaware developers to break that
    markup, the Documentation/ folks have been rather generous and flexible
    in fixing those up, in addition to fixing all the typos as well.

    So I'd be cautiously in favor of the RST conversion, assuming I don't get
    yelled at if I break the markup. ;-)

    Thanks,

    Ingo

    \
     
     \ /
      Last update: 2019-04-23 14:32    [W:6.873 / U:0.004 seconds]
    ©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site