[Sugar-devel] Google Season of Docs

[Samson Goddy]

Anyone can correct me if I am wrong. But the point of Season of Docs is

1. Generate content if none is available.
2. Very important is looking at the existing content and demystify it to
the nearest minimum (Sugar Labs needs this)

The idea for a technical writer is to simplify and transfer information
between Sugar Labs and anyone consuming the content.

To you, the content may look fine because you may not be the target, or in
this case, you are an author of some of the tools generated.

Having great doc is a demanding requirement for onboarding in open source,
and unfortunately, I can't say Sugar Labs has one(simplifications).

Also a completely different from GSoC.


On Wed, Feb 10, 2021, 9:59 AM James Cameron <quozl at laptop.org> wrote:

> My first question was the most important.
>
> I can't think of any documentation Sugar Labs needs that we haven't
> already got in some form or other across our sprawling web presence.
>
> I recommend against proceeding unless some documentation is needed.
>
> On Wed, Feb 10, 2021 at 09:42:40AM +0100, Samson Goddy wrote:
> > Hello James,
> >
> > I read the documentation, yes it looks like a grant based program this
> time
> > around.
> >
> > Just as I mentioned last year, I would love to admin the program, or be
> one of
> > the admins.
> >
> > I am working on a system in place already.
> >
> > Regards
> >
> > On Wed, Feb 10, 2021, 9:33 AM James Cameron <[1]quozl at laptop.org> wrote:
> >
> >     Indeed.  So the question becomes;
> >
> >     - what documentation does Sugar Labs need (e.g. for Sugarizer, Music
> >       Blocks, or Sugar); this forms part of a project proposal,
> >
> >     - who will recruit, evaluate, and onboard a technical writer?
> >
> >     - who will administer the program in Sugar Labs?
> >
> >     [2]https://developers.google.com/season-of-docs/docs/admin-guide
> >
> >     On Wed, Feb 10, 2021 at 08:48:21AM +0100, Favour Kelvin wrote:
> >     > It is being organized differently this year; we have to apply for
> a grant
> >     and
> >     > then we find the writer we reach out directly to the writer we
> want to
> >     work
> >     > with, at least that is how I understood it.
> >     >
> >     > [1][3]https://opensource.googleblog.com/2021/02/
> >     >
> the-2021-season-of-docs-application-for-organizations-is-open.html?m=1
> >     >
> >     > [2][4]
> https://developers.google.com/season-of-docs/docs/tech-writer-guide
> >     >
> >     > On Wed, 10 Feb 2021, 06:18 Saumya Mishra, <[3][5]
> 2017230 at iiitdmj.ac.in>
> >     wrote:
> >     >
> >     >     I think it is a great idea. Sugar labs should take part in
> GSoD.
> >     >
> >     >     Regards
> >     >     Saumya Mishra
> >     >
> >     >     On Wed, Feb 10, 2021 at 7:05 AM James Cameron <[4][6]
> quozl at laptop.org
> >     > wrote:
> >     >
> >     >         It's back.  Can we win a slot this year?  Ideas welcome.
> >     >
> >     >         [5][7]https://opensource.googleblog.com/2021/02/
> >     >
> >      the-2021-season-of-docs-application-for-organizations-is-open.html
> >     >         [6][8]https://developers.google.com/season-of-docs
> >     >
> >     >         --
> >     >         James Cameron
> >     >         [7][9]https://quozl.linux.org.au/
> >     >         _______________________________________________
> >     >         Sugar-devel mailing list
> >     >         [8][10]Sugar-devel at lists.sugarlabs.org
> >     >         [9][11]http://lists.sugarlabs.org/listinfo/sugar-devel
> >     >
> >     >     _______________________________________________
> >     >     Sugar-devel mailing list
> >     >     [10][12]Sugar-devel at lists.sugarlabs.org
> >     >     [11][13]http://lists.sugarlabs.org/listinfo/sugar-devel
> >     >
> >     > References:
> >     >
> >     > [1] [14]https://opensource.googleblog.com/2021/02/
> >
>  the-2021-season-of-docs-application-for-organizations-is-open.html?m=1
> >     > [2] [15]https://developers.google.com/season-of-docs/docs/
> >     tech-writer-guide
> >     > [3] mailto:[16]2017230 at iiitdmj.ac.in
> >     > [4] mailto:[17]quozl at laptop.org
> >     > [5] [18]https://opensource.googleblog.com/2021/02/
> >     the-2021-season-of-docs-application-for-organizations-is-open.html
> >     > [6] [19]https://developers.google.com/season-of-docs
> >     > [7] [20]https://quozl.linux.org.au/
> >     > [8] mailto:[21]Sugar-devel at lists.sugarlabs.org
> >     > [9] [22]http://lists.sugarlabs.org/listinfo/sugar-devel
> >     > [10] mailto:[23]Sugar-devel at lists.sugarlabs.org
> >     > [11] [24]http://lists.sugarlabs.org/listinfo/sugar-devel
> >
> >     --
> >     James Cameron
> >     [25]https://quozl.linux.org.au/
> >     _______________________________________________
> >     Sugar-devel mailing list
> >     [26]Sugar-devel at lists.sugarlabs.org
> >     [27]http://lists.sugarlabs.org/listinfo/sugar-devel
> >
> > References:
> >
> > [1] mailto:quozl at laptop.org
> > [2] https://developers.google.com/season-of-docs/docs/admin-guide
> > [3] https://opensource.googleblog.com/2021/02/
> > [4] https://developers.google.com/season-of-docs/docs/tech-writer-guide
> > [5] mailto:2017230 at iiitdmj.ac.in
> > [6] mailto:quozl at laptop.org
> > [7] https://opensource.googleblog.com/2021/02/
> > [8] https://developers.google.com/season-of-docs
> > [9] https://quozl.linux.org.au/
> > [10] mailto:Sugar-devel at lists.sugarlabs.org
> > [11] http://lists.sugarlabs.org/listinfo/sugar-devel
> > [12] mailto:Sugar-devel at lists.sugarlabs.org
> > [13] http://lists.sugarlabs.org/listinfo/sugar-devel
> > [14]
> https://opensource.googleblog.com/2021/02/the-2021-season-of-docs-application-for-organizations-is-open.html?m=1
> > [15] https://developers.google.com/season-of-docs/docs/tech-writer-guide
> > [16] mailto:2017230 at iiitdmj.ac.in
> > [17] mailto:quozl at laptop.org
> > [18]
> https://opensource.googleblog.com/2021/02/the-2021-season-of-docs-application-for-organizations-is-open.html
> > [19] https://developers.google.com/season-of-docs
> > [20] https://quozl.linux.org.au/
> > [21] mailto:Sugar-devel at lists.sugarlabs.org
> > [22] http://lists.sugarlabs.org/listinfo/sugar-devel
> > [23] mailto:Sugar-devel at lists.sugarlabs.org
> > [24] http://lists.sugarlabs.org/listinfo/sugar-devel
> > [25] https://quozl.linux.org.au/
> > [26] mailto:Sugar-devel at lists.sugarlabs.org
> > [27] http://lists.sugarlabs.org/listinfo/sugar-devel
>
> --
> James Cameron
> https://quozl.linux.org.au/
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.sugarlabs.org/archive/sugar-devel/attachments/20210210/acd4b782/attachment-0001.htm>