docs May 2015

docs@lists.fedoraproject.org

24 participants
46 discussions

Open Help Conference 2015
by Shaun McCance 27 May '15

27 May '15

Hi all, I wanted to let you know that the Open Help Conference is happening again this year, Sept 26-27. http://conf.openhelp.cc/ This will be year 5. It would be great to see some friendly Fedora faces again. After the conference, we also host three days of team sprints. Any team is welcome to join for a sprint. We supply the rooms and the supplies. You supply the people. Let me know if you have any questions. Thanks, Shaun

2 2

Publishing for Fedora 22
by Petr Bokoc 25 May '15

25 May '15

Hey all, First of all, thanks to everyone who contributed to docs for Fedora 22. We're in a much better state for this release than we were for the last one, with significantly more books ready to be published on day one. We still have a long way to go till we have a full documentation set, but it's a big improvement nonetheless. Below is the list of guides which can definitely be safely published tomorrow. Publishing-ready branches are in parentheses: * https://git.fedorahosted.org/cgit/docs/release-notes.git/ (f22) * https://git.fedorahosted.org/cgit/docs/install-guide.git/ (f22-branch) * https://git.fedorahosted.org/cgit/docs/selinux-guide.git/ (F22) * https://git.fedorahosted.org/cgit/docs/virtualization-getting-started-guide… (f22) ----- * https://git.fedorahosted.org/cgit/docs/networking-guide.git/ (22) NOTE: Capesteve still needs to make some commits, but will be ready tomorrow. ----- * https://git.fedorahosted.org/cgit/docs/system-administrators-guide.git/ (f22) - NOTE: It will be ready tomorrow, but jhradilek wants to add a chapter on Systemd; he says he'll be done by Thursday. I don't know if we should publish it ASAP and then republish it a few days later, or if we should wait - I think it's ok to just wait a few days. Randomuser should probably have the final word since he'll be the one publishing it (probably). Also, I remember seeing some activity in a few other books (Amateur Radio Guide, Multiboot Guide, possibly some others), but I don't know what their status is. *If there are any other guides ready for F22 and they're not listed above, please reply to list and add their info (repository and branch).* Regarding the actual publishing - I remember randomuser said he'd do it, so hopefully we're covered; pkovar offered assistance if needed. Cheers, Petr

2 1

Fedora Docs Project Meeting Minutes 25 May 2015
by Petr Kovar 25 May '15

25 May '15

==================================================================================================== #fedora-meeting: Docs Project Meeting - Agenda: https://fedoraproject.org/wiki/Docs_Project_meetings ==================================================================================================== Meeting started by pkovar at 14:33:25 UTC. The full logs are available at http://meetbot.fedoraproject.org/fedora-meeting/2015-05-25/fedora_docs.2015… . Meeting summary --------------- * Roll Call (pkovar, 14:33:45) * New Writers (pkovar, 14:35:22) * Publican/Publishing (pkovar, 14:36:55) * LINK: https://fedoraproject.org/wiki/Docs_Project_Focus (pkovar, 14:38:40) * Guide Status (pkovar, 14:47:40) * LINK: https://fedoraproject.org/wiki/Documentation_Virtualization_Beat?rd=Docs/Be… (lnovich, 14:57:21) Meeting ended at 15:00:57 UTC. Action Items ------------ Action Items, by person ----------------------- * **UNASSIGNED** * (none) People Present (lines said) --------------------------- * pbokoc (33) * pkovar (25) * lnovich (21) * Capesteve (7) * smccann (4) * zodbot (3) * Cydrobolt (1) Generated by `MeetBot`_ 0.1.4 .. _`MeetBot`: http://wiki.debian.org/MeetBot

1 0

Virtualization Getting Started guide ready for F22
by Sandra McCann 25 May '15

25 May '15

Hi folks - I've created the f22 branch for the virtualization getting started guide and I think it's all set for TPTB to publish it tomorrow. Thanks, Sandra

1 0

[Fedocal] Reminder meeting : Fedora Docs Weekly Meeting
by Pete Travis 24 May '15

24 May '15

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

Regarding Fedora badges for Beat Writing
by Ashutosh Bhakare 23 May '15

23 May '15

hi All I have written 2 beats; How to get beat writer badge Regards Ashutosh

5 6

Re: Docs on the wiki (was: Regarding Fedora badges for Beat Writing)
by Ben Cotton 22 May '15

22 May '15

On May 22, 2015 9:51 PM, "Matthew Miller" <mattdm(a)fedoraproject.org> wrote: > > I think our basic goal is moving _user docs_ away from the wiki > entirely, and keeping it as a contributor workspace only -- good for > drafts, for test matrices, etc -- but anything that users would hit > should be on future new "short, more-polished userdocs site". (Anyone > disagree?) > I have no shortage of opinions on the matter, but the TL;DR is that I vehemently agree with this. I'm generally opposed to wikis as documentation for a variety of reasons, but they do have certain appealing traits. If we use them for anything, it should be a drafting ground for new content. Of course, that means doing most of the markup after the fact, which has its own disadvantages, but it lowers the bar for new contributors to come in.

1 0

[Fedocal] Reminder meeting : Docs Office Hours ( Americas )
by Pete Travis 20 May '15

20 May '15

Dear all, You are kindly invited to the meeting: Docs Office Hours ( Americas ) on 2015-05-21 from 12:00:00 to 13:00:00 US/Mountain The meeting will be about: Office hours for Fedora Docs contributors. Stop in to #fedora-docs for help with writing documentation or just to schmooze with the Docs community. Bring your own cake. Source: https://apps.fedoraproject.org/calendar/meeting/434/

1 0

Fwd: Fedora documenation -- installation guide and other guides. General comment.
by Pete Travis 20 May '15

20 May '15

---------- Forwarded message ---------- From: "Leslie S Satenstein" <lsatenstein(a)yahoo.com> Date: May 20, 2015 10:51 AM Subject: Fedora documenation -- installation guide and other guides. General comment. To: "Pete Travis" <me(a)petetravis.com>, "docs-request(a)lists.fedoraproject.org" <docs-request(a)lists.fedoraproject.org> Cc: > I started to review the guide and realized, like many others, that one chapter or section is not included. That one is an address to the reader. > > Should a brief paragraph not be included that stipulates what knowledge and skills the reader is recommended to have? > Should there be a very short set of references for the reader, to where he could rapidly and in a general level, obtain said knowledge and skills? > > Regards > > Leslie > Mr. Leslie Satenstein > Montréal Québec, Canada > This sounds like a path to scope creep to me, and something akin to "You must be at least this experienced with Fedora to install Fedora" would be off-putting. The more complex sections, ie kickstart, are already marked as such. We have been discussing targeting archetypal personas with future documentation, and representing the skill/complexity/experience level required in an unobtrusive way. I'll pass this on to the list for comment. You should also review the list archives for discussions about personas, and https://fedoraproject.org/wiki/Docs_Project_Focus . On the last point, helping readers gain required skills and knowledge - that's what we're all about :) Contributions welcome! --Pete

1 0

Fedora 22 Final Release Readiness Meeting :: Thursday, May 21, 19:00 UTC
by Jaroslav Reznik 19 May '15

19 May '15

Fedora 22 Final Release Readiness Meeting. date: 2015-05-21 place: irc.freenode.net in #fedora-meeting-2 time: 19:00 UTC (3 PM EDT, 12 noon PDT, 21:00 CEST) This Thursday, May 21, we will meet to make sure we are coordinated and ready for the Final release of Fedora 22 on Tuesday, May 26, 2015. Please note that this meeting will occur on May 21 even if the release is delayed at the Go/No-Go meeting on the same day two hours earlier. You may received this message several times, but I was asked to open this meeting to the teams and I'll also hope this will raise awareness and more team representatives will come to this meeting. This meeting works best when we have representatives from all of the teams. We also have a badge! Jaroslav

1 0

2025

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

2009

2008

2007

2006

2005

2004

2003

2002

docs May 2015