develooper Front page | perl.perl5.porters | Postings from November 2021

Re: Pre-RFC: markdown in pod

Thread Previous | Thread Next
From:
Shlomi Fish
Date:
November 18, 2021 08:24
Subject:
Re: Pre-RFC: markdown in pod
Message ID:
20211118102356.0009eb7d@shlomifish.org
Hi Neil!

On Fri, 12 Nov 2021 13:54:02 +0000
Neil Bowers <neilb@neilb.org> wrote:

> Markdown has long since won the battle of simple text-based documentation
> formats. People, not just developers, are used to writing it in lots of
> different places. Odds are that developers trying out Perl, coming from other
> language experience, will be familiar with markdown, and pod will just seem
> weird.
> 

Quoting my page at
https://www.shlomifish.org/philosophy/computers/web/choice-of-docs-formats/ :

'''
Why the Markdown Dialects Should be Avoided as much as Possible [ #markdowns ]

There are too many Markdown dialects (e.g: GitHub's, reddit's, Stack
Exchange's) each one with its own army and navy (= fragmentation and
incompatibilities). Moreover, they can only be converted to XHTML. '''

So I am opposed for making one of the markdowns an integral part of POD. "Only
dead fish go with the flow".

Regards,

	Shlomi
Thread Previous | Thread Next

nntp.perl.org: Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at ask@perl.org | Group listing | About