Front page | perl.perl5.porters |
Postings from March 2009
Russ Allbery wrote:
> Michael G Schwern <schwern@pobox.com> writes:
>> Russ Allbery wrote:
>
>>> I can try to tackle a perlpodstyle documentation page, which I can
>>> either ship with podlators or hand off to the Perl core team as makes
>>> the most sense. I'm somewhat handicapped by not having time to read
>>> perl5-porters, although I do read pod-people.
>
>> Maybe so we can rapidly get chunks of information in there some sort of
>> wiki? Some sort of podwiki?
>> http://www.daemon.de/PodWiki
>
> I personally would prefer not to do text editing in a web browser. I'd be
> happy to use a wiki such as ikiwiki where I can check out the pages with a
> real revision control system and edit them with my regular editor, though.
This might make you happy. I know it makes me happy.
https://addons.mozilla.org/en-US/firefox/addon/4125
> However, before going down that path, I wonder if such a document might be
> only a minor modification of what's in the pod2man man page now, under the
> NOTES section. It's fairly easy for me to start with that and then add
> the requirements for NAME and mail the results (to pod-people?
> perl5-porters?) and invite comment.
Yep, that would be a good place to start. Rather than mail it, I'd just throw
it into version control somewhere. Patch-by-mail is tedious at best, horrible
when it comes to documentation. Throw it up on github or something.
--
The past has a vote, but not a veto.
-- Mordecai M. Kaplan
Thread Previous