Docs meeting 2009-02-04 Summary
by Karsten Wade
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
15 years, 2 months
Unavailable to meet...
by Eric Christensen
$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
15 years, 2 months
[FW: Documentation Beat]
by Paul W. Frields
----- 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
15 years, 2 months
Re: Fedora 10 Release Notes update
by Paul W. Frields
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
15 years, 2 months
Fedora 10 Release Notes Update
by John J. McDonough
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
15 years, 2 months
CMS discussions yet again
by David Nalley
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?
15 years, 2 months
F11 Release Notes Beat Writers
by Eric Christensen
-----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-----
15 years, 2 months
