Seasons of Docs 2020

[Yousuf Philips]

Hi,

Its the end of April now and wanted to remind everyone about this so it can
be looked into, as organizations have til May 4th to apply.


On Tue, Mar 31, 2020 at 10:34 PM Yousuf Philips <ypharis at gmail.com> wrote:

> Hi,
>
> Totally agree there are people willing to contribute and believe there are
> three ways we can help with this.
>
> 1. Get the word out - We have social media presence on twitter and we
> aren't using it to inform potential documentation contributors to help with
> it.
> 2. Lower barrier to entry - Expecting users to file a bug report to then
> contribute to documentation isn't reasonable and not having a means to
> register on the wiki to potentially become an editor is also not inviting.
> If making it easy for people to contribute on a wiki isn't feasible without
> oversight, then maybe we should move to github or gitlab where it would be
> easy to approval push requests.
> 3. Outline areas of interest - We should identify and prioritize places in
> the documentation that need work, which we can point contributors to for
> them to work on
>
> Regards,
> Yousuf
>
> On Tue, Mar 31, 2020 at 4:27 PM Emanuele Petriglia <
> xfce-dev at emanuelepetriglia.com> wrote:
>
>> Hi,
>>
>> I'm certain there are more folks wanting to get involved.
>>
>> I think the same. I always keep an eye on bugzilla[0] to find something
>> to do.
>>
>> This opportunity can be useful to improve not only the documentation but
>> also the workflow.
>>
>> An idea I was thinking is to add man pages to all programs. Xfce programs
>> are mainly GUI, but a basic man page is useful, especially if they have
>> command line arguments. Some distributions, like Debian, provide custom man
>> pages but I think it is better to have them in upstream.
>>
>> [0]:
>> https://bugzilla.xfce.org/buglist.cgi?component=General&list_id=56081&product=docs.xfce.org&resolution=
>> ---
>>
>> On 31/03/2020 10:47, Kevin Bowen wrote:
>>
>> I would definitely be interested in participating in this effort.
>>
>> With the release of 4.14, I spent a bit of effort cleaning up the
>> existing documentation for the release. I've seen a few people step up and
>> contribute. I'm certain there are more folks wanting to get involved.
>> Documentation could be a great gateway to participating in OSS.
>>
>> I would like to see how we can move forward towards 4.16 and provide
>> users with a better experience with the documentation/help system/READMEs.
>>
>> I am willing to be a cheerleader for Xfce docs... ;-)
>>
>> Let me know what I can do. I'd be willing to be a herder of feral cats...
>>
>> kev
>> On 3/27/20 2:58 AM, Sean Davis wrote:
>>
>> This does seem like a good opportunity for us. It looks like applications
>> open up mid-April, so let's keep this is mind.
>>
>> Thanks for the heads up!
>>
>> Sean
>> On 3/24/20 4:11 PM, Yousuf Philips wrote:
>>
>> Hi Teams,
>>
>> I came across this google announcement that I think would benefit the
>> community if we were part of to help improve our documentation.
>>
>>
>> https://opensource.googleblog.com/2020/03/announcing-season-of-docs-2020.html
>>
>> Regards,
>> Yousuf
>>
>> _______________________________________________
>> Xfce4-dev mailing listXfce4-dev at xfce.orghttps://mail.xfce.org/mailman/listinfo/xfce4-dev
>>
>>
>> _______________________________________________
>> Xfce4-dev mailing listXfce4-dev at xfce.orghttps://mail.xfce.org/mailman/listinfo/xfce4-dev
>>
>>
>> _______________________________________________
>> Xfce4-dev mailing listXfce4-dev at xfce.orghttps://mail.xfce.org/mailman/listinfo/xfce4-dev
>>
>> --
>> Emanuele Petriglia (ema-pe)
>>
>> _______________________________________________
>> Xfce4-dev mailing list
>> Xfce4-dev at xfce.org
>> https://mail.xfce.org/mailman/listinfo/xfce4-dev
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://mail.xfce.org/pipermail/xfce4-dev/attachments/20200430/f65f87d3/attachment.html>