Re: Fedora 21 'feature list'
----- Original Message -----
Hey folks! So, while doing my wiki attack lately, one thing I
haven't
been able to resolve is the question of a Fedora 'feature list' since
the Changes process appeared.
Various places seem to treat different pages as a 'feature list', but
none of them seems to be clearly a canonical reference consumable for
outsiders. The most obvious page is:
https://fedoraproject.org/wiki/Releases/21/ChangeSet
which various other pages link to. However, it has an admon header which
reads:
"The Change Set is a project's internal planning and tracking tool and
the final release may not reflect all information provided there!"
which obviously isn't appropriate for something we direct 'general
readers' to, whether it's correct or not (if not, it could just be
removed and then we could use that page, I guess).
It's really not intended for general readers, on the other hand, our wiki
is open. So the admon note is the only way how to say, it's only for
planning purposes as many of changes are still undergoing development,
some changes could be not to be update (I periodically nag owners but
sometime some people loose interest) and you probably remember that
FreeBSD kernel craziness.
The whole idea behind new changes process was - Change pages are hints
for documentation/marketing. The proper coverage will happen in RN
and release announcements. As it's proof-readed, changes are checked to
be in the correct state for that milestone and written in the way for
users.
And yeah, I saw it linked from many websites even with the admon header,
nobody reads it (?) :(. Kamil even asked me to put it to every single
page.
A few pages also link to:
https://fedoraproject.org/wiki/FeatureList
particularly the https://fedoraproject.org/wiki/Fedora_Project_Wiki page
(which is kind of lightly maintained, I think). Up until today, that
page was a redirect or include of Releases/21/FeatureList , which
doesn't exist. Today, someone with the user name Belcocco has written a
rather good summary of Fedora 21 features into it, but I don't know if
that's part of any kind of co-ordinated effort or just a guerilla move.
I'm not sure it was coordinated at all but I like this idea - actually it's
copy paste of the release announcement.
So...I guess I'm saying there seems to be a need for a canonical,
externally-consumable, and accurate 'feature list' for Branched releases
before the release notes are available, and we don't seem to have one.
It'd be good if the relevant folks (docs, marketing, fesco...?) could
come up with a plan and line everything up. Thanks!
I think release announcement is a good starting point. For Alpha, it's
usually pretty short but work on Final is on-going and it's pretty
descriptive with almost all changes. Maybe we can pull it back to Beta,
as Beta is really the first time it makes sense to talk about changes.
Jaroslav
--
Adam Williamson
Fedora QA Community Monkey
IRC: adamw | Twitter: AdamW_Fedora | XMPP: adamw AT happyassassin . net
http://www.happyassassin.net
--
docs mailing list
docs(a)lists.fedoraproject.org
To unsubscribe:
https://admin.fedoraproject.org/mailman/listinfo/docs