Outreachy project about improving documentation and website content (Re: Sign up to mentor for Outreachy Round 15)
El 10/09/17 a las 06:24, Keerthana Krishnan escribió:
> Dear Molly,
> On 6 September 2017 at 19:43, Molly de Blanc <firstname.lastname@example.org
> <mailto:email@example.com>> wrote:
> Hi Keerthana,
> That all sounds great! Debian has had documentation and translation interns
> before. I think not everyone who has signed up to be a mentor (or who has
> been one) is a DD or DM. This shouldn't be a problem, as long as you're
> ready to help someone go through the process of submitting their work
> upstream (if necessary).
> Ofcourse, I'd do my best to help
> There's a form / template on the projects page:
> I've created a basic plan for the project here : 
> I did some initial recon and this is my project idea :
> "The goal of this project is to verify and improve the documentation and the
> website content in Debian. Due to its sheer size and variety, many parts of the
> Debian wiki and websites are in dire need of upgrades and fact-checking. Another
> goal is to create beginner-friendly docs to various sections of the Debian
> project to encourage more first-time contributions. "
> Essentially, I want to improve the docs and hopefully make it easier for the
> first-time contributor.
> Do you want to talk a bit about your project idea and what the application
> project should be? Do you want to have a co-mentor or co-mentors?
> Yes, since I'm very new myself it would be awesome to have someone a bit more
> experienced with the documentation and websites to be a co-mentor. I've done
> documentation before, but never for Debian.
CC'ing website and documentation teams for the case anybody can co-mentor with you.
What follows is about the website part, I'm not member of the documentation team
nor am much familiarized with their repos/sources.
I never mentored in Outreachy/GSoC and I think I personally have not enough
spare time to devote to do a full mentoring (or co-mentoring) in this term, but
I can help in the technical part of changing the website (for example, helping
with the wml syntax, or if the intern submits the proposed changes as bugs to
the www.debian.org pseudopackages, I can review them and upload them when they
are ready. Well, if the outreachy intern sends their "deliverables" in form of
patches, anybody in the website team can review/upload ;) I just mean that I
would try to prioritize those so you can evaluate their work as mentor based in
the team output).
Maybe you can find useful to use usertags
to categorize as "content" or "documentation" the website bugs that the intern
can work on:
For now, we have the following bugs tagged as "content":
Maybe there is another (better) way to do this, but as I said, I have no
Laura Arjona Reina
> Also, due to this inexperience, I wouldn't mind being a co-mentor who supports
> with the writing and documentation part while someone else with more familiarity
> to the Debian systems is the main mentor
> Thanks for reaching out. It's really cool when people who were mentored want
> to help others get involved. :)
> It feels so great to give back in any way I can!
>  :