Monday, September 28, 2015

I'm back...

Been traveling a bit, so haven't updated lately, but I've not been entirely idle. Have recently added
docs for with/without, loop LINEs, next, last, redo, state, and while/until.

I'm considering trying to consolidate the documentation efforts into something more coherent than what we have presently. It would be very nice to actually have it all in order for the Christmas release of Perl 6. But that's an actual commitment, so I'm not fully convinced yet... Watch this space for something resembling a decision!

In the meantime, I have a question for Perl 5 programmers or anyone else who would like to render an opinion:

What makes for good documentation?

One of the things people have liked about Perl is that, for many years, it has had good, extensive documentation. I'm now wondering about what it is that appeals to people and how those qualities can be usefully applied to documenting Perl 6.

Your thoughts?