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).
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.
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!
@Adam Unfortunately it is true, there is no coordination, and we must still do a lot. However I correct something. Thanks for the tip. Bye. Sergio
Il giorno Fri, 26 Sep 2014 19:48:50 -0700 Adam Williamson adamwill@fedoraproject.org ha scritto:
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).
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.
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!
----- 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@lists.fedoraproject.org To unsubscribe: https://admin.fedoraproject.org/mailman/listinfo/docs
marketing@lists.fedoraproject.org
-
Adam Williamson -
Jaroslav Reznik -
Sergio Agnes