Grant Report : Improving Perl 6 Documentation - May 2018
Thu, 07-Jun-2018 by
Mark A Jensen
edit post
We call him... The Closer.
JJ made 324 commits in May on top of the 195 in April to
[https://github.com/perl6/doc](https://github.com/perl6/doc), and is
now [tied with
Zoffix](https://jj.github.io/TPF-Grant/illos/closers-perl6-doc-ranking/)
as the top closer of issues in the repo.
He also sketched out most of the missing pages in the [Issue of the
Thousand Days](https://github.com/perl6/doc/issues/114), the Perl6
Docs Roadmap. That enabled that albatross to be tossed overboard as
well.
JJ has also written a couple of [metadocuments](https://www.researchgate.net/publication/325532706_Author_and_file_entropy_in_the_Perl_6_documentation_repository),
describing patterns he
has observed in the distributions of time-to-complete for
documentation and other classes of Perl6 issues. He offers a number of
conclusions regarding how to effectively move issues along in an
all-volunteer effort like Perl6. Spoiler alert: pretty much, you have
to let people work on what they want, or stuff doesn't get done. The
downside is, the big projects that need lots of help are generally
less attractive, and so languish.
(Which is where TPF and its grantees come to the rescue.)
You can read all the details with link in [his blog for
May](https://jj.github.io/TPF-Grant/May.html).
MAJ
Comments (0)