docs August 2016

docs@lists.stg.fedoraproject.org

19 participants
31 discussions

Tooling, Tooling, Tooling
by Brian Exelbierd 22 Sep '16

22 Sep '16

This email is to drive some discussion around $subject. It follows from a blog soon to be posted on the Fedora Community blog (https://communityblog.fedoraproject.org) The text below is copied from that blog: Tooling, Tooling, Tooling There was strong consensus around changing to new tools and markups. In fact, most of the tooling conversations were held in small groups near the end of the meeting. There was a desire to continue to see a drive to simpler contribution and publication. The only significant question was around the community, upstream adoption and contributor base for pintail which is the central tool in the new processing flow. People were very concerned that there wasn't evidence of enough adoption and contribution to prevent the project from being at risk of going either unmaintained or slowly maintained. Please reply here for discussion. regards, bex

8 17

I found a small hole in documentation
by Lailah 13 Sep '16

13 Sep '16

Hello folks, I was trying to install Fedora in a laptop but I didn't want to delete the Windows partition, just shrink it. I naturally looked up in Documentation as it's not obvious in the partitioner how to shrink a partition to make room in hard disk. I didn't find it. Not I found it anywhere else. I eventually found it out by myself so I would like to help others documenting the process or if it's a known bug, adding a warning to documents. Now.... How can I do that? Cheers and thanks, Sylvia

4 9

Self-Introduction: Tushar Kumar
by Tushar Kumar 04 Sep '16

04 Sep '16

Hello, I used to contribute for Fedora Docs a couple of years back. Back then, I was a student and after few months of contribution, I had to leave because of my new job. However, here I am introducing myself once again. I started using Linux in 2006 and after sorting out various things, I left the world of windows and began using Linux full time from 2008. I educated myself in computer science and in 2011, I did RHCE. Soon after college, I decided to follow my hobby and choose writing, which led me to become an assistant editor at an online news publication. Although I am here purely out of love for open source and Fedora Linux, but my intention is to learn and know more about Linux operating system, as the same curiosity got me started in the first place. I am willing to contribute my skills in docs and would like to expand to other technical areas as time progresses. I appreciate you all for reading this. Looking forward to a new beginning. May the force be with you. :) -- Regards, Tushar Kumar IRC: tkumar Email: info(a)tusharkumar.org PGP Key ID: c6098d5d46139188

2 2

Fwd: randomuser's meeting titled "Docs Project Meeting - Agenda: https://fedoraproject.org/wiki/Docs_Project_meetings" ended in #fedora-meeting
by Pete Travis 29 Aug '16

29 Aug '16

Here are the minutes from this morning's minutes, for those of you not subscribed to the meetingminutes list. -- Pete ---------- Forwarded message ---------- From: <notifications(a)fedoraproject.org> Date: Aug 29, 2016 09:59 Subject: randomuser's meeting titled "Docs Project Meeting - Agenda: https://fedoraproject.org/wiki/Docs_Project_meetings" ended in #fedora-meeting To: <meetingminutes(a)lists.fedoraproject.org> Cc: ============================================================ ======================================== #fedora-meeting: Docs Project Meeting - Agenda: https://fedoraproject.org/ wiki/Docs_Project_meetings ============================================================ ======================================== Meeting started by randomuser at 14:01:15 UTC. The full logs are available at https://meetbot.fedoraproject.org/fedora-meeting/2016-08-29/ fedora_docs.2016-08-29-14.01.log.html . Meeting summary --------------- * Roll Call (randomuser, 14:01:16) * New Writers (randomuser, 14:04:19) * Where are with the Release Cycle and Docs? (randomuser, 14:11:01) * LINK: https://fedorapeople.org/groups/schedule/f-25/f-25-docs-tasks.html (randomuser, 14:11:26) * ACTION: randomuser to update beats table (randomuser, 14:14:08) * ACTION: bexelbie to contact marketing/commblog about having article writers for new features do a release note too (bexelbie, 14:19:40) * Specific Doc Status (randomuser, 14:23:31) * What has changed with specific docs? What needs to be republished? Any blockers or issues? (randomuser, 14:24:26) * virt getting started guide probably needs to be republished (randomuser, 14:24:37) * prototyping asciidoc stuff in the cookbook (randomuser, 14:38:40) * LINK: https://fedorapeople.org/~bex/pintail/ (bexelbie, 14:39:59) * test build of Install Guide with bex mods using pintail (bexelbie, 14:40:07) * Outstanding BZ Tickets (randomuser, 14:55:05) * idle thought - some script or panel to aggregate pagure issues from all our projects into a single view would be neat (randomuser, 14:56:00) * Open Floor Discussion (randomuser, 14:56:56) Meeting ended at 14:59:50 UTC. Action Items ------------ * randomuser to update beats table * bexelbie to contact marketing/commblog about having article writers for new features do a release note too Action Items, by person ----------------------- * bexelbie * bexelbie to contact marketing/commblog about having article writers for new features do a release note too * randomuser * randomuser to update beats table * **UNASSIGNED** * (none) People Present (lines said) --------------------------- * randomuser (81) * bexelbie (25) * pbokoc (11) * tkumar (11) * zodbot (9) * zoglesby (9) * pkovar (5) * jflory7 (2) * Capesteve (1) Generated by `MeetBot`_ 0.1.4 .. _`MeetBot`: http://wiki.debian.org/MeetBot https://meetbot.fedoraproject.org/fedora-meeting/2016-08-29/ fedora_docs.2016-08-29-14.01.html -- You received this message due to your preference settings at https://apps.fedoraproject.org/notifications/fmnmeetingminutes.id. fedoraproject.org/email/29368 _______________________________________________ meetingminutes mailing list meetingminutes(a)lists.fedoraproject.org https://lists.fedoraproject.org/admin/lists/meetingminutes@lists. fedoraproject.org

1 0

[Fedocal] Reminder meeting : Fedora Docs Weekly Meeting
by Pete Travis 28 Aug '16

28 Aug '16

Dear all, You are kindly invited to the meeting: Fedora Docs Weekly Meeting on 2016-08-29 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

[Bug 1366780] New: Spelling mistake in Box title
by Red Hat Bugzilla 22 Aug '16

22 Aug '16

https://bugzilla.redhat.com/show_bug.cgi?id=1366780 Bug ID: 1366780 Summary: Spelling mistake in Box title Product: Fedora Documentation Version: devel Component: user-guide Assignee: docs(a)lists.fedoraproject.org Reporter: landrae(a)stud.hs-bremen.de QA Contact: docs-qa(a)lists.fedoraproject.org CC: danielsmw(a)gmail.com, docs(a)lists.fedoraproject.org, jmbabich(a)gmail.com, pkovar(a)redhat.com, rlandman(a)redhat.com, zach(a)oglesby.co Document URL: https://docs.fedoraproject.org/de-DE/index.html Section Number and Name: The "Anmerkung" box Describe the issue: In the Title it says : "Anmerkung - Nicht jedes Dokument ist ind jeder Sprache verfügbar" Suggestions for improvement: should say: "Anmerkung - Nicht jedes Dokument ist in jeder Sprache verfügbar" Additional information: Description of problem: a "d" to much Version-Release number of selected component (if applicable): How reproducible: go to the page and look at the Anmerkung box Steps to Reproduce: 1.Open Browser 2.go to https://docs.fedoraproject.org/de-DE/ -- You are receiving this mail because: You are on the CC list for the bug. You are the assignee for the bug.

1 4

[Fedocal] Reminder meeting : Fedora Docs Weekly Meeting
by Pete Travis 21 Aug '16

21 Aug '16

Dear all, You are kindly invited to the meeting: Fedora Docs Weekly Meeting on 2016-08-22 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

Should we stop publishing the current guides now?
by Brian Exelbierd 18 Aug '16

18 Aug '16

This email is to drive some discussion around $subject. It follows from a blog soon to be posted on the Fedora Community blog (https://communityblog.fedoraproject.org) The text below is copied from that blog: Should we stop publishing the current guides now? The requirement to keep publishing the current guides feels very self-imposed. Continuing to publish them is a challenge for the new tooling as it has to be built to accommodate the past and therefore slows down the future. Additionally, publishing the current books spreads our resources very thinly, if not past the breaking point. It also creates inertia which prevents the move to topics. Confusion can result from this as well because contributors don't know what to update (old books or new topics). Lastly, there is a growing belief in the larger documentation community that no docs is better than old docs. Here this is a direct reference to the fact that we don't republish all the docs for every release and we don't thoroughly review every doc that is published. Versioned docs are important, but some old materials is probably going to cause problems (i.e. references to yum or iptables.) One proposal was to have a "flag day" where we stop updating the current docs and another day (or same day) where we stop the publication. this would definitely need to be moderated for versions not end of lifed. Please reply here for discussion. regards, bex

9 13

Video about pintail @ GUADEC
by Jean-Baptiste 15 Aug '16

15 Aug '16

hi, you may want to watch the video "Build all the docs in pintail" by Shaun McCance at GUADEC : https://media.ccc.de/v/108-unconference-6 it sounds promising, even if the biggest problem looks like to be translation ;) enjoy, -- Jean-Baptiste Holcroft

2 1

Translation needs clarity on how to get updates published and the process.
by Brian Exelbierd 15 Aug '16

15 Aug '16

This email is to drive some discussion around $subject. It follows from a blog soon to be posted on the Fedora Community blog (https://communityblog.fedoraproject.org) The text below is copied from that blog: Translation needs clarity on how to get updates published and the process. This seemed like a communication problem between the two projects that needed to be resolved with better docs on the process and hand-off procedures. Because the tooling proposal will hopefully include continuous deployment, this may become a lot easier in the future. Please reply here for discussion. regards, bex

5 4

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

2009

2008

2007

2006

2005

2004

2003

2002

docs August 2016