Matthew Kenworthy <[email protected]> wrote:

> I think treating the PODs as the 'ground truth' documents from which
> all other formats are generated could be the way to go. So I suggest
> this:
> 
> Remove the half-completed PDL books from the wiki pages completely.

+1

> I'd be willing to go through the PDL
> books, pull out the great examples and POD ify them, so that the PODs
> can be wikified automatically.

Yay.

This brings a related question: Is it better to PODify the wiki or
wikify the POD?

One way or the other, I think the documentation should be all developed
in one place (POD + git, or wiki) and then either convert the POD to
wiki or convert the wiki to POD.

One way or the other we would have to move some documents. The wiki and
the POD both have good documents that are worth keeping.

I'll leave it to others to weigh the pros and cons of using POD or the
wiki. You understand the issues better than I do.

Daniel.

_______________________________________________
Perldl mailing list
[email protected]
http://mailman.jach.hawaii.edu/mailman/listinfo/perldl

Reply via email to