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

Re: Pre-RFC: markdown in pod

Thread Previous | Thread Next
From:
Ovid via perl5-porters
Date:
November 22, 2021 20:12
Subject:
Re: Pre-RFC: markdown in pod
Message ID:
1784021675.1692479.1637611929210@mail.yahoo.com
What if we punted on much of this and allow:

    =poddown

    This is basic C<markdown> plus `pod`.

    =cut

I was thinking about this because I saw the Playwright documentation (https://metacpan.org/pod/Playwright) which clearly has some accidental Markdown that's unrendered:

    See https://playwright.dev/versions and drill down into your relevant
    version (run `npm list playwright` ) for what the classes do, and their usage.

We don't promise more than basic markdown support.

    * this
    * would
    * be
    * a
    * list

    =over 4

    =item * this

    =item * would
 
    =item * also

    =item * be

    =item * a

    =item * list

    =back

And we can look at something proper later? You'd get the basic convenience of Markdown but the other features of POD. Older POD parsers would simply default to what we currently have.

No tables until we could figure out something later.

Best,
Ovid
-- 
IT consulting, training, specializing in Perl, databases, and agile development
http://www.allaroundtheworld.fr/. 

Buy my book! - http://bit.ly/beginning_perl

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