docs February 2009

docs@lists.fedoraproject.org

36 participants
62 discussions

Docs meeting 2009-02-04 Summary
by Karsten Wade 04 Feb '09

04 Feb '09

Attending ========= John J. McDonough (jjmcd) Zach Oglesby (zoglesby) Paul W. Frields (stickster) David Nalley (ke4qqq) Karsten Wade (quaid) Mike McGrath (mmcgrath) Simon Birtwistle (itbegins) IRC log ======= https://fedoraproject.org/wiki/Meeting:Docs_IRC_log_20090204 Summary ======= * Docs schedule -- quaid to talk about it with Sparks, ryanlerch, and others throughout the day via IRC, then ratify by ~0100 UTC Th. * CMS ** Packages built or in the works (we are using 8 modules) *** ke4qqq + zikula person are packaging ** Changes we requested turned in to a dedicated server build in the Zikula universe (vs. a shared hosting); these changes are in the 1.1.1 release just out. ** mmcgrath explained about how we do test authentication; any missing useful test environments we need are available soonest * Release notes -- Alpha one page is on wiki; ryanlerch converted them to DocBook XML/Publican, but they need to be published further from there. ** Until the CMS is in place, there is a trade-off between Publican-based Alpha/Beta notes and the ability to publish just-in-time via the wiki. If the relnotes team wants to do the latter, they need to update the schedule with content freezes and alert e.g. releng about the freezes so they know they cannot add last minute content at the literally last minute. * Installation Guide ** Writers needed, call to go out soon -- join while it's HOT! ** ke4qqq getting bug reports now * Security Guide -- please update via f-docs-l * SELinux Guide -- please update via f-docs-l * User Guide -- please update via f-docs-l * Meeting time -- not addressed, on list? * Wiki pages changes -- not addressed -- Karsten 'quaid' Wade, Community Gardener http://quaid.fedorapeople.org AD0E0C41

1 0

FDSCo Meeting Reminder
by Eric Christensen 04 Feb '09

04 Feb '09

REMINDER: There will be a FDSCo Meeting today at 1900 UTC. The agenda can be found at: http://fedoraproject.org/wiki/DocsProject/SteeringCommittee/Meetings

4 5

Unavailable to meet...
by Eric Christensen 04 Feb '09

04 Feb '09

$DAYJOB has requested my presence for a meeting this afternoon at the exact same time the Docs meeting will be going on. Can someone handle leading the meeting today, please? Eric

2 1

[FW: Documentation Beat]
by Paul W. Frields 04 Feb '09

04 Feb '09

----- Forwarded message from Jason Taylor <jmtaylor90(a)gmail.com> ----- From: Jason Taylor <jmtaylor90(a)gmail.com> To: fedora-news-list(a)redhat.com Date: Wed, 04 Feb 2009 09:42:57 -0500 Subject: Documentation Beat X-BeenThere: fedora-news-list(a)redhat.com Due to a new job and having to move I am not, in the forseeable future going to be able to dedicate time to the Doc beat. This being the case, if someone wants to take it over, that would be great! TIA... ----- End forwarded message ----- Is there anyone in Docs who's interested in taking up the Documentation beat for the Fedora Weekly News? The responsibilities are fairly simple and basically amount to summarizing over the weekend whatever major events happened during the previous week. The FWN is generally issued on Monday evenings (UTC time). -- Paul W. Frields http://paul.frields.org/ gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233 5906 ACDB C937 BD11 3717 http://redhat.com/ - - - - http://pfrields.fedorapeople.org/ irc.freenode.net: stickster @ #fedora-docs, #fedora-devel, #fredlug

2 2

comment on your wiki changes please
by Karsten Wade 04 Feb '09

04 Feb '09

Whenever you make any change to the wiki, please put a comment in the appropriate field. This is good open source practice. The idea is to see why you did something, more than what. However, the wiki doesn't always reveal the diff for a viewer (e.g. watch email), so having a brief explanation of what you did is not verbotten. For another plea with cool graphics: http://ianweller.org/2009/01/25/an-important-notice-from-your-wiki-people/ -- Karsten 'quaid' Wade, Community Gardener http://quaid.fedorapeople.org AD0E0C41

2 1

Re: Fedora 10 Release Notes update
by Paul W. Frields 03 Feb '09

03 Feb '09

On Tue, Feb 03, 2009 at 09:56:06PM +0100, Geert Warrink wrote: > The new pot has been pushed into the devel branch. > I suppose you intended to push it in the f-10 branch? Whoops, we'll have to remedy that. No content has changed from F-10 to devel other than the updates we want to push, so it should be safe to merge those changes back from 'devel' -> 'f10'. -- Paul W. Frields http://paul.frields.org/ gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233 5906 ACDB C937 BD11 3717 http://redhat.com/ - - - - http://pfrields.fedorapeople.org/ irc.freenode.net: stickster @ #fedora-docs, #fedora-devel, #fredlug

1 0

Fedora 10 Release Notes Update
by John J. McDonough 03 Feb '09

03 Feb '09

The other day we decided it was about time for an update to the F10 release notes. I had some things to update, and I see by the git logs that Karsten was busy, too. So today I pushed what I believe to be the final needed changes to git. But what are the next steps? We need to push these changes to docs.fp.o, but I notice when I build them they have draft plastered all over them and the style looks different. So somehow they need to be built clean and then somehow moved to docs.fp.o. Then I presume we need to get the changes translated. And then turned into a package. So what are all these hidden steps that Paul and Karsten have been doing in the dead of night? --McD

3 6

Fedora 11 Schedules
by John Poelstra 03 Feb '09

03 Feb '09

I have complete a draft of the translation schedule for Fedora 11. It is based on the documentation schedule (which to date I have not received any feedback). http://poelstra.fedorapeople.org/schedules/f-11/f-11-trans-tasks.html http://poelstra.fedorapeople.org/schedules/f-11/f-11-docs-tasks.html A new report I am still ironing out (huge credit goes to Ben Kahn for creating it for me) is a combined view of the Docs and Translations schedule with different color codings for each team. http://poelstra.fedorapeople.org/schedules/f-11/f-11-docs-and-trans-tasks.h… Please review the reports in detail to make sure I have the correct dates and task durations. If you like we can schedule a time to meet on IRC or phone to work out any remaining changes. We will also touch on some of these tasks at the release readiness meeting. If I do not hear any feedback by Monday, February 2, 2009, I will assume that both the Documentation and Translation schedules are correct. Thanks, John

4 6

CMS discussions yet again
by David Nalley 03 Feb '09

03 Feb '09

Sparks, jsmith and I were talking in IRC and I thought the conversation should have a bit wider audience. I think that while kbase and housing documentation for packaging guidelines and legal are excellent use cases for a CMS, I wonder if by trying to use it for everything we are not trying to use a hammer to drive a screw. My reason for saying that is that it seems like we are trying to push all of our non-wiki documentation into the CMS, which at least from my perspectives means we, to one degree or another, are abandoning DocBook. For our 'heavy' documents, such as Release Notes, User Guide, and Security Guide, I don't see an escape from DocBook - it provides a lot of advantages that just don't exist in a CMS. It does have disadvantages to be sure, but I guess the question in my mind is with all of the talk of moving to a CMS are we really prepared to ditch DocBook and it's benefits? Or is the CMS a solution for things like Legal and Packaging Guidelines, and potentially a knowledgebase, and not more? Thoughts, Comments, Flames?

7 9

F11 Release Notes Beat Writers
by Eric Christensen 03 Feb '09

03 Feb '09

-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 It's that time of year, again! Time to hit the streets to get all the new Fedora goodness documented! There are two kinds of people receiving this message. The first kind of recipient are those that had a beat assignment for F10. If you are one of these please go over to the wiki[1] and verify that your assignment is still correct. While you are over there please remove the "*" from your name so we know you are still on board. The second kind of recipient are those that were not on the beat list but probably should be. If you are one of these please go over to the wiki[1] and sign up for one of the open slots. Don't wait around because the best slots go fast! [1] https://fedoraproject.org/wiki/Documentation_Beats Thanks, Eric Christensen E-Mail: sparks(a)fedoraproject.org GPG Fingerprint: CA02 4ACA EB6C 1A76 F0D6 1127 7D04 D240 BD0C 14C1 -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.9 (GNU/Linux) Comment: Using GnuPG with Fedora - http://enigmail.mozdev.org iEYEARECAAYFAkl2Zz4ACgkQfQTSQL0MFMGY0gCfSTpt7D3Bzli8wzbh4Mr5gFBA lsEAnjLFKUkzBjWUaLyAV86VtGFn/3qY =6xb4 -----END PGP SIGNATURE-----

5 5

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 2009