We need your help with the Perl 6 documentation
Tags: perl6, documentation, graffiti, resume
Published: 2018-05-20 19:35:18

---
title: We need your help with the Perl 6 documentation
published: True
description: How to become part of the Perl 6 community by helping with the documentation
tags: perl6, documentation, graffiti, resume
---
![Helping with a mural](https://thepracticaldev.s3.amazonaws.com/i/bkngnnlzkdlmd5upe2pl.JPG)
I've always wanted to be a graffiti artist. So I attended an urban art workshop last week by a [great writer, Sendra](https://www.instagram.com/rpsendra/)
> By the way [Paula](https://dev.to/terceranexus6) was there too, but her art is great already. And that segues into my main point.

You learn graffiti, like programming, by doing. But you can't just be given a [wall](https://www.flickr.com/photos/atalaya/41453941004/in/dateposted/), a few [Montana sprays](https://www.flickr.com/photos/atalaya/42128561382/in/dateposted/) and some encouragement, and, here, you're already a graffiti writer. No you're not.
What Sendra did was to bring along a couple of other local artists, [Nas](https://www.instagram.com/alberto.color/) and [Flecha](https://www.instagram.com/flechauno/), and after defining roughly what was going to be done, they [drafted on the wall](https://www.flickr.com/photos/atalaya/42171882741/in/dateposted/) so that, for us newbies, it was kinda paint-by-numbers. We still learned a lot, but we were helped part of the way. At the same time, if one, or all, of them, would have wanted to do the whole wall, it would have taken a lot of time. There's a lot of grunt work involved, and that's where we newbies could help.
Same happens with other thing I'm involved with: the [Perl 6 documentation](https://docs.perl6.org/). I [got a grant for improving it](http://news.perlfoundation.org/2018/02/grant-proposal-curating-and-im.html), and have been working on it for a couple of months. It's a never ending task, so we need your help.

## You can help

You don't need a lot of qualifications to help with documentation. On a level, it's just text, and text is written by humans and it can have errors. So you can just spot awkward phrasing, spelling mistakes (there shouldn't be any, but it happens) and simply better ways so say something. 

But it's also documentation for a purpose, having people do stuff in [Perl 6, which is one of the most amazing languages](https://perl6.org). If after reading the documentation it fails to convey what you want it to say, [raise an issue](https://github.com/perl6/doc/issues). 

## You can **really** help

And then there are the issues [we really want help with](https://github.com/perl6/doc/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22). I have tagged just one, to help prospective contributors focus. In this issue new pages have to be written, and you will need to know at least the foundations of the language. The [rest can be found out in a straightforward way](https://dev.to/jj/squashing-perl-6-documentation-bugs-one-at-a-time-4ojn).

## We can help you too

I might have said this already, but Perl 6 is a great language. Even if you're not interested in the language itself, it's great to learn about [Unicode](https://docs.perl6.org/language/unicode) or [concurrency](https://docs.perl6.org/language/concurrency). Documenting a language from scratch makes for great resume entry. You have to delve into the source code and tests and literally create documentation out of thin air. And the documentation will be there for people to use and re-use it. So by helping us you can acquire lots of skills, and we can help you along the way.

## Just like graffiti

Eventually, we created a [beautiful wall](https://www.flickr.com/photos/atalaya/28304182088/in/dateposted/) (meet again [Paula](https://dev.to/terceranexus6) working on the upper levels), newbies and veterans together, in this [graffiti jam](https://www.google.com/url?sa=t&rct=j&q=&esrc=s&source=web&cd=6&cad=rja&uact=8&ved=0ahUKEwjFjNDig5XbAhXIUBQKHdbYAK0QtwIIOTAF&url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3Dny2kjLUS2vs&usg=AOvVaw0Lg1ihMAQ2CCyBbKWjj2_a). I feel proud of the part [I personally worked on](https://www.flickr.com/photos/atalaya/27302200817/in/dateposted/), and also of the whole thing, because I was part of it.

Do you want to feel proud of the [Perl 6 documentation](https://perl6.org)? Help us make it a bit greater and better!