[prev in list] [next in list] [prev in thread] [next in thread] 

List:       fedora-docs-list
Subject:    Re: google season of docs
From:       "Brian (bex) Exelbierd" <bexelbie () redhat ! com>
Date:       2019-03-12 10:54:00
Message-ID: CAE6uQMvw=G9H4E7Zp2NgPVFM7f8HbZFNToMGdxSGc-w88d4VeA () mail ! gmail ! com
[Download RAW message or body]

[Attachment #2 (multipart/alternative)]


On Tue, Mar 12, 2019 at 9:35 AM Robert Kratky <rkratky@gmail.com> wrote:

> On 03/12/2019 03:52 AM, Justin W. Flory wrote:
> > On 3/11/19 5:37 PM, Matthew Miller wrote:
> >> This seems like it has potential!
> >>
> >>
> https://opensource.googleblog.com/2019/03/introducing-season-of-docs.html
> >>
> >
> > My personal suggestion is to wait for the program to mature before
> > volunteering Fedora.


My primary concern is having mentoring support and a well identified set of
tasks.  If Petr Bokoc can take charge here then I think we can be
successful.  I suspect that, at a minimum, we could have someone come in
and do things like refactor the installation guide by edition or review and
update docs for the current release.  We should, imho, make sure this
person focuses on F30, not F29 as that is what should be current for most
if not all of the cycle.

I am happy to coordinate our application and work with Petr to get it done.

regards,

bex


> >
> > I am skeptical. My first impression is it is a technical writing
> > certification program from Google, and open source projects act as
> > volunteer certificate proctors.
> >
> > There was a long discussion about this on the Google GSoC mailing list.
> > A key difference of Season of Docs is technical writers are not paid.
> > This excludes a group of people in most need for professional experience
> > and mentorship. It also sends an implied message about the value of
> > technical writing; Season of Docs is the only Google open source program
> > (to my knowledge) without a stipend or compensation of time (GSoC with
> > paid stipend, GCI with sponsored trip to Google HQ).
> >
> > My first impression was not boarding the bandwagon yet and observing how
> > the program matures first. I would like equal treatment for technical
> > writing and development work before endorsing the program.
> >
> > My intention is not to be pessimistic, but I am disappointed this
> > feedback seems unaccounted for in how Season of Docs is currently
> > described and promoted.
>
> Hi Justin,
>
> Maybe the conditions have changed since you first learned about the
> program. The FAQ [1] says:
>
> "Is Season of Docs considered an internship, a job, or any form of
> employment?"
>
> Season of Docs is an activity that the technical writer performs as an
> independent technical writer for which they are paid a stipend. Technical
> writers may choose to opt out of receiving the stipend."
>
> and:
>
> "Will I be paid for participating in Season of Docs?
>
> Yes. Google will provide a stipend to those technical writers who
> successfully complete the program. You can choose to opt out of receiving
> the stipend."
>
> So, maybe we could give it a thought.
>
> Regards,
> Robert
> _______________________________________________
> docs mailing list -- docs@lists.fedoraproject.org
> To unsubscribe send an email to docs-leave@lists.fedoraproject.org
> Fedora Code of Conduct: https://getfedora.org/code-of-conduct.html
> List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines
> List Archives:
> https://lists.fedoraproject.org/archives/list/docs@lists.fedoraproject.org
>
-- 
Brian (bex) Exelbierd | bexelbie@redhat.com | bex@pobox.com
Fedora Community Action & Impact Coordinator
@bexelbie | http://www.winglemeyer.org

[Attachment #5 (text/html)]

<div><br></div><div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On \
Tue, Mar 12, 2019 at 9:35 AM Robert Kratky &lt;<a \
href="mailto:rkratky@gmail.com">rkratky@gmail.com</a>&gt; wrote:<br></div><blockquote \
class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc \
solid;padding-left:1ex">On 03/12/2019 03:52 AM, Justin W. Flory wrote:<br> &gt; On \
3/11/19 5:37 PM, Matthew Miller wrote:<br> &gt;&gt; This seems like it has \
potential!<br> &gt;&gt;<br>
&gt;&gt; <a href="https://opensource.googleblog.com/2019/03/introducing-season-of-docs.html" \
rel="noreferrer" target="_blank">https://opensource.googleblog.com/2019/03/introducing-season-of-docs.html</a><br>
 &gt;&gt;<br>
&gt; <br>
&gt; My personal suggestion is to wait for the program to mature before<br>
&gt; volunteering Fedora.</blockquote><div dir="auto"><br></div><div dir="auto">My \
primary concern is having mentoring support and a well identified set of tasks.   If \
Petr Bokoc can take charge here then I think we can be successful.   I suspect that, \
at a minimum, we could have someone come in and do things like refactor the \
installation guide by edition or review and update docs for the current release.   We \
should, imho, make sure this person focuses on F30, not F29 as that is what should be \
current for most if not all of the cycle.</div><div dir="auto"><br></div><div \
dir="auto">I am happy to coordinate our application and work with Petr to get it \
done.</div><div dir="auto"><br></div><div dir="auto">regards,</div><div \
dir="auto"><br></div><div dir="auto">bex</div><div dir="auto"><br></div><blockquote \
class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc \
solid;padding-left:1ex"><br> &gt; <br>
&gt; I am skeptical. My first impression is it is a technical writing<br>
&gt; certification program from Google, and open source projects act as<br>
&gt; volunteer certificate proctors.<br>
&gt; <br>
&gt; There was a long discussion about this on the Google GSoC mailing list.<br>
&gt; A key difference of Season of Docs is technical writers are not paid.<br>
&gt; This excludes a group of people in most need for professional experience<br>
&gt; and mentorship. It also sends an implied message about the value of<br>
&gt; technical writing; Season of Docs is the only Google open source program<br>
&gt; (to my knowledge) without a stipend or compensation of time (GSoC with<br>
&gt; paid stipend, GCI with sponsored trip to Google HQ).<br>
&gt; <br>
&gt; My first impression was not boarding the bandwagon yet and observing how<br>
&gt; the program matures first. I would like equal treatment for technical<br>
&gt; writing and development work before endorsing the program.<br>
&gt; <br>
&gt; My intention is not to be pessimistic, but I am disappointed this<br>
&gt; feedback seems unaccounted for in how Season of Docs is currently<br>
&gt; described and promoted.<br>
<br>
Hi Justin,<br>
<br>
Maybe the conditions have changed since you first learned about the program. The FAQ \
[1] says:<br> <br>
&quot;Is Season of Docs considered an internship, a job, or any form of \
employment?&quot;<br> <br>
Season of Docs is an activity that the technical writer performs as an independent \
technical writer for which they are paid a stipend. Technical writers may choose to \
opt out of receiving the stipend.&quot;<br> <br>
and:<br>
<br>
&quot;Will I be paid for participating in Season of Docs?<br>
<br>
Yes. Google will provide a stipend to those technical writers who successfully \
complete the program. You can choose to opt out of receiving the stipend.&quot;<br> \
<br> So, maybe we could give it a thought.<br>
<br>
Regards,<br>
Robert<br>
_______________________________________________<br>
docs mailing list -- <a href="mailto:docs@lists.fedoraproject.org" \
target="_blank">docs@lists.fedoraproject.org</a><br> To unsubscribe send an email to \
<a href="mailto:docs-leave@lists.fedoraproject.org" \
target="_blank">docs-leave@lists.fedoraproject.org</a><br> Fedora Code of Conduct: <a \
href="https://getfedora.org/code-of-conduct.html" rel="noreferrer" \
target="_blank">https://getfedora.org/code-of-conduct.html</a><br> List Guidelines: \
<a href="https://fedoraproject.org/wiki/Mailing_list_guidelines" rel="noreferrer" \
target="_blank">https://fedoraproject.org/wiki/Mailing_list_guidelines</a><br> List \
Archives: <a href="https://lists.fedoraproject.org/archives/list/docs@lists.fedoraproject.org" \
rel="noreferrer" target="_blank">https://lists.fedoraproject.org/archives/list/docs@lists.fedoraproject.org</a><br>
 </blockquote></div></div>-- <br><div dir="ltr" class="gmail_signature" \
data-smartmail="gmail_signature">Brian (bex) Exelbierd | <a \
href="mailto:bexelbie@redhat.com" target="_blank">bexelbie@redhat.com</a> | <a \
href="mailto:bex@pobox.com" target="_blank">bex@pobox.com</a><br>Fedora Community \
Action &amp; Impact Coordinator<br>@bexelbie | <a href="http://www.winglemeyer.org" \
target="_blank">http://www.winglemeyer.org</a></div>


[Attachment #6 (text/plain)]

_______________________________________________
docs mailing list -- docs@lists.fedoraproject.org
To unsubscribe send an email to docs-leave@lists.fedoraproject.org
Fedora Code of Conduct: https://getfedora.org/code-of-conduct.html
List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines
List Archives: https://lists.fedoraproject.org/archives/list/docs@lists.fedoraproject.org


[prev in list] [next in list] [prev in thread] [next in thread] 

Configure | About | News | Add a list | Sponsored by KoreLogic