F11: What went wrong? What went right?
by Eric Christensen
During the Fedora Activity Day (FAD) after the SouthEast LinuxFest
(SELF) we discussed several topics concerning the Fedora 11 release.
The complete day's notes are available on the wiki[1] for your review.
I will be pasting from the wiki into these messages in order to
hopefully begin some discussion on how we can make our next release much
better. I'll post this initial post and then provide comments within.
I encourage all Docs Project members provide their comments as well.
What went wrong
Changing Release Notes data
* Two days before F11 was released, the release notes beats on wiki were
still changing
* Audio change
* Networking issue
* Expect full-timers to include info
Secret cabal-driven freezes that aren't communicated
* (leading to people not knowing about freezes occurring and when RN
data needed.)
* this is also a comms problem on our part.
Too many rogue documents.
Getting RPMs pushed - going through f13 takes as much time as building
the rpm
* We need to be able to push packages ourselves (i.e. need instructions,
guidelines, etc.)
* Not enough packagers in Docs
* Only f13 and stickster know how to push RNs -- need more
co-maintainers
Could use more clarity understanding on what is implied by freezes,
trans, etc
Need more interaction with L10n
Bugs not being filled out in timely manner
* Many RN bugs arrive at the last minute that were known early on
-indeed (SEE ABOVE)
Need to centralize where bugs are filed (too many choices -- BZ, Trac
instances...)
* BZ even has too many subchoices (components, etc.)
Poor notations on where/how bugs/issues should be filed
Wiki search SUCKS BIG TIME!!
No good documentation on moving things from wiki to DocBook/Publican
stores
Could use more consistency in wiki markup
Need better documentation on what we want to use from DocBook markup
No good process for dealing with orphan documents
RN documents are not all in one place (about-fedora, readme's, etc.)
Lack of understanding of release schedule process
Publican and Fedora/GNOME lang codes not consistent
* Not at all clear how login lang selected is used
Translators having too much work.
Release notes are ill-defined
* Too long for normal users to read
* Beats have inconsistent levels of content
* Need some separation
We don't know anything about visit statistics for docs.fp.o
We need a more rigorous freeze on wiki release note beats
* Notes to f-docs-l, f-trans-l f-dev-l several times before each
milestone
BZ URL ulink default in Publican is unhelpful at best
Not clear if remaining (obsolete? unmaintained?) docs need conversion to
Publican (strikes me as part of undefined orphan process)
docs.fp.o site sucks (Mo knows)
* Need solution for people to install a doc just for their lang, in
their format
* No CMS, no easy publishing, high barrier to participation
* No real indexing...
What went right
DOCS PEOPLE ROCK
Many more docs/guides available than ever before!! (we rocked!)
The wiki didn't asplode, but should have. (yay!)
Everything seemed a lot more organized this release
+ Packaging is easier than it sounds
+ The install guide is awesome
++ Some folks really rolled up their sleeves and helped - zoglesby,
laubersm, rudi
much better collaboration this release cycle
felt far less rushed than F10
stickster and quaid got out of the way and Sparks got run over
Brisbane folks represented, yo
Red Hat relicensed guide material in a way where we can generate
community presence around them
[1] https://fedoraproject.org/wiki/FAD_Documentation_Meeting_2009_06_14
Thanks,
Eric
14 years, 10 months
FAD @ SELF
by John J. McDonough
I just wanted to take a moment to thank David and Eric for organizing a very
productive FAD. Sure the audio didn't work out as well as we might have
liked, I screwed up on trying to record it, and we got started late, but boy
did we get a lot done.
We identified a whole pile of things we would like to see better, but then
were able to focus that discussion down to a manageable number of things
that we actually might do. Viewed from my narrow release notes perspective,
this was a really big win. There is work to be done to be sure, but we have
some clear direction and we know what the big hitters are. There were lots
of things that went well, too. Sometimes we forget those, but it is good to
recognize them so we can leverage them next time.
Paul then walked us through the whole business of po and pot files, and what
the translators have to deal with. Most of this was old new to me, having
been baptized by fire in F11, but it was good to see the knowledge getting
spread around, and I think it is especially helpful to understand what
impact our actions have on L10n.
Then Ian Weller did a little packaging class, and we rolled up our sleeves
and packaged a bunch of Zikula modules. There is still more to do, but we
made a terrific amount of progress in a very short time.
We tracked the meeting in Gobby, and that document will be posted to the
wiki shortly so those that couldn't join in can at least see the major
thoughts. Sorry about the recording, but then a six or so hour audio
wouldn't be that much fun to listen too, anyway.
Thanks to those who worked hard to make this happen, and to all the folks
who were able to join in, add to the discussions, and do the work. It was a
day well spent.
--McD
14 years, 10 months
Re: fedora-docs-list Digest, Vol 64, Issue 21
by Lee Brewer
I was there at 9am waiting on "those who partied too hard" to show up.
Bah wah wah wah!!!
--
____________________________
~uclugLee
sent using Fedora(11) Linux
Evolution email
Smoothwall
On Sun, 2009-06-14 at 12:00 -0400, fedora-docs-list-request(a)redhat.com
wrote:
>
> ----------------------------------------------------------------------
> Message: 2
> Date: Sat, 13 Jun 2009 13:44:48 -0400
> From: Eric Christensen <eric(a)christensenplace.us>
> Subject: Tomorrow's FAD Start Time
> To: For participants of the Documentation Project
> <fedora-docs-list(a)redhat.com>, For discussions about marketing and
> expanding the Fedora user base <fedora-marketing-list(a)redhat.com>
> Message-ID:
> <c5cb00220906131044v3dbb99a5k85f1709d88111ac7(a)mail.gmail.com>
> Content-Type: text/plain; charset=UTF-8
>
> Any complaints to starting tomorrow's FAD at 9A (EDT) versus 10A?
>
> Eric
>
>
>
> ------------------------------
>
> Message: 3
> Date: Sat, 13 Jun 2009 15:43:43 -0400
> From: Paul Frields <stickster(a)gmail.com>
> Subject: Re: Tomorrow's FAD Start Time
> To: For participants of the Documentation Project
> <fedora-docs-list(a)redhat.com>
> Message-ID:
> <ef93afcf0906131243o74a93002ua0980925009154d1(a)mail.gmail.com>
> Content-Type: text/plain; charset=ISO-8859-1
>
> On Sat, Jun 13, 2009 at 1:44 PM, Eric
> Christensen<eric(a)christensenplace.us> wrote:
> > Any complaints to starting tomorrow's FAD at 9A (EDT) versus 10A?
> >
> > Eric
>
> A bunch of us are planning on being there at 9am. Don't miss out on an
> extra hour of fun! ;-)
>
> Paul
14 years, 10 months
Upgrade Doc?
by Eric Christensen
Do we need to make a single page guide for upgrading to the latest
version of F? My question comes from the fact that at the Fedora
table at SELF I noted a BUNCH of F10 disks on the table. I saw F11
disks on the table after the morning keynote speaker so that was good
but I wonder if it would be a good idea to have a web address that we
can point someone to if they do pick up a F10 disk because that's all
the person running the table has at the time.
Eric
14 years, 10 months
Introduction
by Sri Ram
Hi,
I am Sri Ram. I working with fedora community for a long period. i am
interested in contributing to Fedora Documentation Project. I am documented
the fedora 10 release announcement for my LUG. Link :
https://fedoraproject.org/w/uploads/7/72/Fedora10_Release_Announcement_KK...
Details:
Name : Sri Ram
IRC Nickname : emplinux
--
Regards
Sriram B
--
Fedora Ambassador - India
empoweringlinux(a)fedoraproject.org
Key fingerprint : B3FF F8AE 4576 1CB2 51E0 1118 5B70 C4EB A575 A19A
14 years, 10 months
Transifex 0.6 on its way
by Ruediger Landmann
Forwarded from f-t-l -- Yay!
-------- Original Message --------
Subject: translate.fedoraproject.org changes
Date: Fri, 12 Jun 2009 17:08:11 -0400
From: Ricky Zhou <ricky(a)fedoraproject.org>
Reply-To: Fedora Translation Project List <fedora-trans-list(a)redhat.com>
To: fedora-trans-list(a)redhat.com
Hey, as Dimitris requested at
https://fedorahosted.org/fedora-infrastructure/ticket/1455, we're going
to start getting rid of the old services under
translate.fedoraproject.org. Today, we will be doing the first three
items on the task list in the ticket, and testing for Transifex 0.6 on a
test server will start soon after.
Just giving everybody a heads up, and thanks to the Transifex team for
all their work our translation infrastructure!
Thanks,
Ricky
14 years, 10 months
Docs FAD at the Southeast Linuxfest
by David Nalley
Just a quick note on the Docs FAD on June 14th that will follow the
Southeast Linuxfest in Clemson SC.
We have 8 attendees listed thus far:
http://fedoraproject.org/wiki/FAD_SELF
And I am sure that we will have even more show up, and hopefully a few
recruited the day before.
We have a significant contingent of contributors that are unable to
attend. We will use Docs Project's conference bridge (2008) on Fedora
Talk to let those join the conversation. This is particularly
important during the Docs Decisions for F12.
Currently my proposed itinerary is: (times below are eastern)
9:00 AM - 10:30 AM - Docs Decisions for F12
http://fedoraproject.org/wiki/Docs_decisions_for_F12
10:30 AM - 11:30 AM A non-translator's introduction to the POT/PO model
11:30 AM - Balance of the day working on zikula modules and getting
packaging instruction from Ian Weller
If there's demand, we'll get Paul to provide an introduction to
DocBook. as well.
If you don't like this schedule, please feel free to suggest changes
If you are remotely interested in the Docs Project, and are in the
southeast, please consider attending, it will be a huge benefit for
you and the project.
14 years, 10 months