docs February 2018

docs@lists.fedoraproject.org

8 participants
13 discussions

Docs FAD - Day 3 notes
by Justin W. Flory 28 Feb '18

28 Feb '18

Hi all, the Docs FAD wrapped up earlier for Day 3. Today's highlight discussions included a deep-dive into figuring out CI/CD for Pagure repos + doc contributions, creating the style guide for new docs, and more. The Etherpad still probably gives the best picture on what's happening "on the ground". A few links to highlight: http://etherpad.osuosl.org/fdocs2018 https://pagure.io/fedora-docs/documentation-guide https://pagure.io/fedora-commops/onboarding-guide Thanks to our remotees for participating again today. We'll be back for Day 4 tomorrow! = = = = = Meeting ended Wed Feb 28 21:08:20 2018 UTC. Minutes: https://meetbot.fedoraproject.org/fedora-docs/2018-02-28/fedora_docs.2018-0… Minutes (text): https://meetbot.fedoraproject.org/fedora-docs/2018-02-28/fedora_docs.2018-0… Log: https://meetbot.fedoraproject.org/fedora-docs/2018-02-28/fedora_docs.2018-0… * * * * * =================================================== #fedora-docs: Fedora Documentation FAD 2018 - Day 3 =================================================== Meeting started by jwf at 10:23:27 UTC. The full logs are available at https://meetbot.fedoraproject.org/fedora-docs/2018-02-28/fedora_docs.2018-0… . Meeting summary --------------- * Hack Time! (jwf, 10:23:40) * LINK: https://pagure.io/fedora-docs/quick-docs/pull-request/21#comment-46592 (jwf, 11:14:21) * And now, a change of pace: food! (jwf, 11:34:44) * Hack Time! (Round 2) (jwf, 12:43:21) * LINK: https://pagure.io/fedora-commops/onboarding-guide (jwf, 13:46:05) * LINK: https://about.gitlab.com/2016/05/10/feature-highlight-push-to-remote-reposi… (mattdm, 14:19:25) * LINK: http://etherpad.osuosl.org/fedora-style-guide (jwf, 15:13:23) * LINK: https://redhat-documentation.github.io/asciidoc-markup-conventions/ (jwf, 15:18:32) Meeting ended at 21:08:20 UTC. Action Items ------------ Action Items, by person ----------------------- * **UNASSIGNED** * (none) People Present (lines said) --------------------------- * jwf (59) * bexelbie (25) * rkratky (18) * mjahoda (12) * zodbot (11) * cverna (9) * zoglesby (9) * jsmith (9) * mattdm (7) * coremodule (5) * mayorga (4) * bstinson (3) * asamalik[m] (1) * ssitani (0) * ryanlerch (0) * sumantro (0) * langdon (0) Generated by `MeetBot`_ 0.1.4 .. _`MeetBot`: http://wiki.debian.org/MeetBot -- Cheers, Justin W. Flory jflory7(a)gmail.com

1 0

Docs FAD - Day 2 notes
by Justin W. Flory 27 Feb '18

27 Feb '18

Hi all, Day 2 of the Docs FAD wrapped up a moment ago. Today's minutes are more barebone but the full logs may be more helpful. We spent most of the day working hands-on on different areas. The Etherpad we created is likely more helpful to see what is to do, what is being done, and what is done. http://etherpad.osuosl.org/fdocs2018 We'll be back tomorrow! See you all then. * * * * * Meeting ended Tue Feb 27 19:07:59 2018 UTC. Minutes: https://meetbot.fedoraproject.org/fedora-docs/2018-02-27/fedora_docs.2018-0… Minutes (text): https://meetbot.fedoraproject.org/fedora-docs/2018-02-27/fedora_docs.2018-0… Log: https://meetbot.fedoraproject.org/fedora-docs/2018-02-27/fedora_docs.2018-0… = = = = = =================================================== #fedora-docs: Fedora Documentation FAD 2018 - Day 2 =================================================== Meeting started by jwf at 08:30:39 UTC. The full logs are available at https://meetbot.fedoraproject.org/fedora-docs/2018-02-27/fedora_docs.2018-0… . Meeting summary --------------- * Hack Time! (jwf, 08:31:42) * Today is less talking, more working – less minutes but feel free to ask questions, join remotely, and participate in the docs-fest! (jwf, 08:32:18) * LINK: https://fedoraproject.org/wiki/Community_Blog (jwf, 08:43:55) * LINK: https://fedoraproject.org/wiki/Planet (jwf, 08:44:03) * LINK: https://pagure.io/fedora-commops/pull-request/140 (jwf, 08:48:21) * LINK: https://pagure.io/fedora-commops/pull-request/141 (jwf, 09:36:31) * LINK: http://etherpad.osuosl.org/fdocs2018 (jwf, 10:13:51) * LINK: https://fedoraproject.org/wiki/Category:How_to (jwf, 10:30:33) * LINK: https://fedoraproject.org/wiki/Writing_how_to_documentation_on_the_wiki (jwf, 10:32:25) * LINK: http://stylepedia.net/ (jwf, 10:51:26) * It'sssss lunch time! (jwf, 11:49:24) * Hack Time! (Round 2) (jwf, 13:40:29) * LINK: https://pagure.io/fedora-commops/onboarding-guide (jwf, 14:48:57) * LINK: https://docs.stg.fedoraproject.org/ (ryanlerch, 16:44:38) * LINK: https://docs.stg.fedoraproject.org/ (x3mboy, 17:00:08) Meeting ended at 19:07:59 UTC. Action Items ------------ Action Items, by person ----------------------- * **UNASSIGNED** * (none) People Present (lines said) --------------------------- * jwf (104) * cverna (73) * bexelbie (38) * asamalik[m] (24) * langdon (23) * bstinson (23) * zodbot (19) * Srijita (11) * jsmith (9) * ryanlerch (6) * mattdm (6) * x3mboy (6) * sumantro_ (5) * ssitani (4) * zoglesby (4) * coremodule (3) * rkratky (2) * mayorga (1) Generated by `MeetBot`_ 0.1.4 .. _`MeetBot`: http://wiki.debian.org/MeetBot -- Cheers, Justin W. Flory Intern, UNICEF Office of Innovation jflory(a)unicef.org -- Cheers, Justin W. Flory jflory7(a)gmail.com

1 0

introduction!
by Matthew Miller 27 Feb '18

27 Feb '18

Hi! I'm Matthew Miller and I'd like to officially join the docs team. I've done some stuff around Fedora for a while, and have written quite a few wiki pages, Fedora Magazine articles, and a lot of the high-level project documentation. :) -- Matthew Miller <mattdm(a)fedoraproject.org> Fedora Project Leader

2 1

valelint: English linter with AsciiDoc support
by Justin W. Flory 27 Feb '18

27 Feb '18

Hi all, During the FAD, mayorga found a Golang tool called valelint: it gives feedback on English and ways to improve writing. https://valelint.github.io/docs/ https://github.com/ValeLint/vale Sadly, it isn't packaged for Fedora (yet) but may be a useful tool for some of us still. -- Cheers, Justin W. Flory jflory7(a)gmail.com

1 0

Docs FAD - Day 1 notes
by Justin W. Flory 26 Feb '18

26 Feb '18

Hi all! Day 1 of the FAD wrapped up a moment ago here in Seville. We used IRC during the day to take notes. We had a lot of discussion this morning, but most of the FAD will probably be hands-on from here (so less detailed minutes). We'll be back in IRC tomorrow. If you want to jump in and participate, find us in #fedora-docs. * * * * * Meeting ended Mon Feb 26 18:07:42 2018 UTC. Minutes: https://meetbot.fedoraproject.org/fedora-docs/2018-02-26/fedora_docs.2018-0… Minutes (text): https://meetbot.fedoraproject.org/fedora-docs/2018-02-26/fedora_docs.2018-0… Log: https://meetbot.fedoraproject.org/fedora-docs/2018-02-26/fedora_docs.2018-0… -- Cheers, Justin W. Flory jflory7(a)gmail.com

1 0

[Fedocal] Reminder meeting : Fedora Docs Weekly Meeting
by immanetize＠fedoraproject.org 26 Feb '18

26 Feb '18

Dear all, You are kindly invited to the meeting: Fedora Docs Weekly Meeting on 2018-02-26 from 14:00:00 to 15:00:00 UTC At fedora-meeting(a)irc.freenode.net The meeting will be about: An hour of docs folks talking about what they are working on and what they'd like to work on. More information available at: [https://fedoraproject.org/wiki/Docs_Project_meetings](https://fedoraproject… Source: https://apps.fedoraproject.org/calendar/meeting/371/

2 1

Re: Wiki page 'Subprojects' needs some love
by Justin W. Flory 21 Feb '18

21 Feb '18

On 02/20/2018 11:44 PM, Jhoanir Torres wrote: > Hi Justin, > > I saw this wiki page [1] about 'Subprojects' with this message: > " This page needs some love > This page should be revised or reconstructed to be more helpful. > Problems may include being out of step with current team or project > status or process. " > > And I wonder what can I do? in order to give some 'love' to that page. > > [1] https://fedoraproject.org/wiki/Subprojects > > > Thanks in advance > Hey Jhoanir! I am including the Fedora Docs mailing list in this reply. This information is mostly a list of all sub-projects with a short description of each group; I think this content is more valuable for documentation than it is in the wiki. There is a page in the docs for this specific wiki page, but it has a big TODO comment to be completed later. https://docs.fedoraproject.org/fedora-project/subprojects/subprojects.html I think the following steps would be good to follow: 1. Verify wiki page information is accurate / correct 2. Convert wiki page to AsciiDoc document 3. Create pull request to Fedora Docs to update the page This gets the content into our docs and makes it more useful than a "TODO" comment. We may want to make bigger changes to this page in the future, but I think it makes more sense to get something up than a blank page. I need someone from the Docs team to clarify where this page lives. I found this, but it's HTML, not an AsciiDoc file. https://pagure.io/fedora-docs/docs-fp-o/blob/master/f/other-releases-main.h… If someone from the docs-side can clarify where this lives, I'm sure your help to migrate it from the wiki to docs would be helpful. Are you interested in working on this? -- Cheers, Justin W. Flory jflory7(a)gmail.com

3 2

Docs FAD: What can we "bring"?
by Justin W. Flory 20 Feb '18

20 Feb '18

Hi all, Part of the Docs FAD purpose¹ includes a contributor handbook; in CommOps, we are discussing guidelines for GSoC / Outreachy mentors in documentation. Is work like this included in the scope of the FAD? We have a few docs-related areas of focus in CommOps and I hoped to work at them during the FAD². However, the scope of work for the FAD is unclear to me in this way, if the FAD is meant to focus on tasks like this. More context is in this ticket: https://pagure.io/fedora-commops/issue/133 I want to make sure my expectations are in line with reality for the FAD, but didn't want to assume. Does it make sense for participants to "bring" tasks like this into the FAD? Thanks! ¹ https://fedoraproject.org/wiki/FAD_Documentation_2018#Purpose ² https://pagure.io/fedora-docs/issue/11 -- Cheers, Justin W. Flory jflory7(a)gmail.com

3 3

[Fedocal] Reminder meeting : Fedora Docs Weekly Meeting
by immanetize＠fedoraproject.org 18 Feb '18

18 Feb '18

Dear all, You are kindly invited to the meeting: Fedora Docs Weekly Meeting on 2018-02-19 from 14:00:00 to 15:00:00 UTC At fedora-meeting(a)irc.freenode.net The meeting will be about: An hour of docs folks talking about what they are working on and what they'd like to work on. More information available at: [https://fedoraproject.org/wiki/Docs_Project_meetings](https://fedoraproject… Source: https://apps.fedoraproject.org/calendar/meeting/371/

1 0

Translation to Portuguese / Tutorial Production
by Henrique Tamashiro 12 Feb '18

12 Feb '18

Hi guys! I'm a Brazilian programmer, how can i help with the documentation? thanks.

2 1

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

2009

2008

2007

2006

2005

2004

2003

2002

docs February 2018