develooper Front page | perl.qa | Postings from May 2015

Re: Documenting best practices and the state of ToolChain guidelinesusing CPAN and POD

Thread Previous
From:
Kent Fredric
Date:
May 6, 2015 18:42
Subject:
Re: Documenting best practices and the state of ToolChain guidelinesusing CPAN and POD
Message ID:
CAATnKFBzr4jRk1M+HaZc=CXKAAh0Q4xprVBGDs6cfk1SxCkX=g@mail.gmail.com
On 7 May 2015 at 02:46, H.Merijn Brand <h.m.brand@xs4all.nl> wrote:

> How much I admire this effort (+1000 as you say from me as well), I
> think a structured HTML doc that people can download and read or PDF
> with index will reach a wider audience.
>


Generally, with HTML, if I want to read HTML, I need a browser. Having the
HTML on disk there just serves as an annoyance factor while I tell my OS to
tell my browser to open the file. ( To contrast with "perldoc Foo" or
<!mcpan foo> in my search bar, needing to locate an ABSPATH first is a bit
annoying )

Generally that implies I have internet, and so a website ( such as metacpan
) is an ideal Go-To.

I would not be opposed to HTML and PDF renditions of said policies being
available, the PDF is of course more likely to be amenable for people who
just want to read it on their phone/kindle/whatever.

And you could, perhaps, periodically aggregate the Policy::<> stuff docs
published to CPAN and format them to a single doc and potentially ship that
with perl .... but I find it hard to imagine P5P wants to elevate
"toolchain + CPAN policies" to "part of perl itself" level.

I find it hard to imagine any of this would be integrated with perl itself,
in any way, no matter how it was formatted, because a large amount of the
concerns presented don't pertain to "Perl itself", but to the CPAN
Ecosystem in general.

-- 
Kent

*KENTNL* - https://metacpan.org/author/KENTNL

Thread Previous


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