Re: New Contributors & Documentation Style Guide

[Sindhu S <sindhus live in>]

Hi again!

As the tasks page content is a little more a couple of paragraphs, I
think that's why they have included it in a different page besides,
tasks deserves to have a page of it's own I think. Single landing page
for a newbie to quickly know the requirements before attempting to
contribute is great but if the page is extremely lengthy, 2 scrolls
down I feel newbies loose interest and enthusiasm unable to make sense
of the information galore in there.

Then again, you could draft your own ideal landing page for those
wanting to contribute to the GNOME Documentation project under your
live.gnome.org username like I have done .../sindhus/xxxx and have it
posted on the docs list for a review? If it's better than the existing
one, am sure they'll be happy to replace it with yours! :)

-Sindhu

On Fri, Mar 29, 2013 at 1:50 AM, Bastian Hougaard <gnome rvzt net> wrote:
> Hi Sindhu,
>
> On Fri, 2013-03-29 at 00:50 +0530, Sindhu S wrote:
> > I am currently an intern with the documentation team and I have
> > written a practical docs workflow guide for newbies, please take a
> > look at https://live.gnome.org/sindhus/SuggestedWorkflowForWritingUserHelp
> Nice work! I am sure this will be helpful.
>
>
> > I'd love to expand into the idea of an updated GDP Style guide that
> > includes not just workflow but also current recommended practices for
> > GNOME Documentation. Do you any suggestions?
>
> Sounds like a good idea. I don't think I am the right person to ask for
> suggestions though (I am new), but perhaps someone else has some
> suggestions.
>
> By the way, I also just noticed that
> https://live.gnome.org/DocumentationProject/Tasks/ has some links
> recommended ("Is there anything I should read first"). It might make
> more sense to put these links in
> https://live.gnome.org/DocumentationProject/Contributing
> and then refer back to this page so everything newcomers need to study
> can be found in one place. Just a suggestion. What do you think?
>
> Thank you in advance,
>
> Bastian