Re: [gentoo-dev] markdown docs like README.md

[Tom Wijsman]

On Tue, 24 Sep 2013 22:15:15 +0200
Michał Górny <mgorny@g.o> wrote:

> Dnia 2013-09-24, o godz. 19:49:33
> hasufell <hasufell@g.o> napisał(a):
>
> > I wonder if it would make any sense to take the effort to convert
> > markdown docs to html format before installing them.
>
> What for? The point of markups like Markdown is for the text to be
> readable as plain text. Converting it to HTML goes against
> this principle.

You are pulling things out of context. Let me quote [1]:

> Thus, “Markdown” is two things: (1) a plain text formatting syntax;
> and (2) a software tool, written in Perl, that converts the plain
> text formatting to HTML.

(1) If it is a formatting syntax, then why would we make text any
more readable than it already is; actually, by mangling it with
formatting constructs it could even end up being less readable.

(2) It is a tool as well, saying it goes against a principle would be
denying its existence and usefulness; consider that the global use of
Markdown consists of a lot of conversion, we shouldn't neglect that
people want to use it as it benefits them.

Principle or not, we shouldn't force our users down a particular way to
reading them; as that's not what our meta-distribution stands for.

 [1]: http://daringfireball.net/projects/markdown/

-- 
With kind regards,

Tom Wijsman (TomWij)
Gentoo Developer

E-mail address  : TomWij@g.o
GPG Public Key  : 6D34E57D
GPG Fingerprint : C165 AF18 AB4C 400B C3D2  ABF0 95B2 1FCD 6D34 E57D