Seasons of Docs 2020

[Yousuf Philips]

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/20200331/5310bd8b/attachment-0001.html>