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

Re: Pre-RFC: markdown in pod

Thread Previous | Thread Next
Shlomi Fish
November 18, 2021 08:24
Re: Pre-RFC: markdown in pod
Message ID:
Hi Neil!

On Fri, 12 Nov 2021 13:54:02 +0000
Neil Bowers <> 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 :

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".



Thread Previous | Thread Next Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at | Group listing | About