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

List:       fedora-docs-list
Subject:    Re: Season of Docs
From:       Petr Bokoc <pbokoc () redhat ! com>
Date:       2019-04-18 9:54:52
Message-ID: 74a1de7e-d9b0-2d6b-a246-0a254dcfd1c2 () redhat ! com
[Download RAW message or body]

Hi,

I'm doing this way late late - my bad, I've had a pretty terrible April 
so far with a string of events that made me mostly unavailable. In 
retrospect I should have probably said something sooner :/. We have till 
Tuesday 20:00 UTC, and I think we might still be able to pull something off.

Shaun, thank you for offering to be a mentor.

I also contacted the installer team yesterday, asking if anyone would 
like to be a "technical" mentor for the install guide rewrite proposal.

Other than mentors, we'll need two "Organization administrators", people 
who would manage the participation of Fedora in GSoD. Do we have anyone? 
Brian, do you think you could do that? And do we know anyone else who 
might be able to/want to step up? I originally thought I'd take one of 
the spots, but I think I'd be of more use as a mentor, and I don't think 
one person can be both.

By the way, I can't find this anywhere in the docs: can a single mentor 
offer to mentor multiple projects?

Regarding projects, if we can have the same person (i.e. me) offer to 
mentor multiple projects, then I'd propose the following:

* Refactor or enhance the Fedora Installation Guide by creating 
separately published documents for each Fedora variant 
(Workstation/Server/Cloud), taking advantage of Antora

* Update and enhance current contributor documentation, including 
developing ASCIIDoc markup guidelines and providing a set of ASCIIDoc 
snippets for common text editors (Atom, Vim, Emacs, Gedit)

* Create a documentation set aimed at users completely new to Linux and 
Fedora in particular, focusing on describing alternatives to software 
commonly used on other operating systems (such as web browsers, 
productivity suites, video/music players, image/video editing 
software…), and concepts such as package management and updates

Personally I could mentor any of those, or even offer to mentor all of 
them if that's allowed.

If we manage to agree on something, I can work on making a docs page for 
GSoD over the weekend, I got the flu so I'm not going anywhere anyway.

What do you think?

Petr


On 4/4/19 6:26 PM, Brian (bex) Exelbierd wrote:
> On Thu, Apr 4, 2019 at 5:48 PM Shaun McCance <shaunm@gnome.org> wrote:
> > I'd like to re-open the conversation about Season of Docs. Here's the
> > previous thread, for reference:
> We forgot to write on that thread, but it was in irc (terrible comms
> hygiene - sorry) that Fedora is working on the application for Season
> of Docs.
> 
> > https://lists.fedoraproject.org/archives/list/docs@lists.fedoraproject.org/thread/EPO4ATPUOCUL4NLOWD33KXXQS5HOIV2N/
> >  
> > I'm willing to invest some time into coordinating Fedora's involvement,
> > whether that's as an actual admin, or just helping the admins here and
> > there. Here are a few ideas for possible projects:
> > 
> > * Quick start guides for the different spins
> > 
> > * Contributor guide
> > 
> > * Security guide
> > 
> > * Guides geared toward specific types of server deployments, such as
> > storage, virtualization, container platform, etc
> > 
> > * Guide geared toward developers using Fedora as their development
> > platform, as a developer workstation, as a testing/CI platform, and as
> > a deployment platform
> > 
> > Each individual project must have two mentors, which is different from
> > how GSoC has run. (Maybe they'll change GSoC too.) But, mentors don't
> > always need to be people who hang out on this list. We should look for
> > people working on those areas to help mentor. Find a developer working
> > on Fedora security to help mentor a security guide, for example.
> It'd be great to see people step up the plate on these ideas.  It
> seems like with Shaun, we need just one more person to get at least
> one idea on the table.
> 
> regards,
> 
> bex
> _______________________________________________
> 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
> 
_______________________________________________
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]