Major wiki revisions: release process documentation, package maintenance instructions, repository documentation, Changes...
9:58 p.m.
Hi, folks. As I hinted a bit, and as some of you might know from IRC,
I've spent the last ~24 hours on something of an epic Wiki revision
spree. I made some fairly major and possibly significant changes, so
under the 'ask forgiveness' principle I thought I'd post a quick summary
here.
* As already mentioned, the "Change Deadlines" are no more. They are now
"Milestone Freezes". See
https://fedoraproject.org/wiki/Milestone_freezes . (Yeah, I can't decide
on the capitalization). All (I think) significant linking pages have
been updated appropriately. The new page should, I hope, form a useful
and succinct guide to how the milestone freezes actually work.
* https://fedoraproject.org/wiki/Fedora_Release_Life_Cycle has been
extensively updated and overhauled to reflect the current Fedora release
process. I have added links to it to quite a lot of pages as I went
along.
* https://fedoraproject.org/wiki/Repositories is an entirely new page
which specifically documents the Fedora repositories. Again, I have
added links to this page from several other pages.
* https://fedoraproject.org/wiki/Package_update_HOWTO is extensively
overhauled. I ditched the huge, weird tables full of Xs which didn't
appear to convey any useful information at all. Stuff that was about
using the SCM, not actually about doing updates, was removed (see next
line item). The rest of the content has been heavily modified and
updated to reflect current practice and policies and, well, just be
better.
* https://fedoraproject.org/wiki/Package_maintenance_guide has been
created from three (and a bit) sources: the package maintenance bits
from the "Package update HOWTO", the "Using Fedora GIT" page which it
is
a rename of, and the "Using_git_FAQ_for_package_maintainers" page which
now redirects to it. Having stuff about using the SCM in three different
places, and half of it outdated since Fedora 14, seemed a bad idea. I
believe it subsumes all the still-valid and useful content from all
three sources, and adds some new and updated information. I like the
format for the main guide/walkthrough, with the expandable notes for
each step, but yell if you don't.
* Various pages were adjusted to link or redirect to the above two
pages.
* There's a "Change Wrangler" page now -
https://fedoraproject.org/wiki/Change_Wrangler - and some things which
used to link to Jaroslav personally now link there (or to
https://fedoraproject.org/wiki/Fedora_Program_Management , whichever is
appropriate).
* https://fedoraproject.org/wiki/ReleaseEngineering/Overview was
extensively overhauled.
* https://fedoraproject.org/wiki/Updates_Policy was adjusted to match
the other changes. Nothing about the actual *policy it sets* was
adjusted (at least not intentionally, please do check for mistakes), but
various names were changed, links were redirected, and so on. Some of
its descriptions of procedures were adjusted to reflect reality,
principally in regards to Bodhi enabling and the early Branched period.
* The old "Feature Freeze Policy" (which had been search-and-replaced to
the "Change Freeze Policy", which caused it to finally cease to bear
*any* resemblance to reality whatsoever) and "Branch Freeze Policy"
pages have been effectively factored out of existence. The "Feature
Freeze" is replaced by the Change "freezes" / checkpoints described at
https://fedoraproject.org/wiki/Changes/Policy and by the milestone
freezes. The "Branch Freeze" is replaced by the concept of the "Bodhi
enabling point", documented at
https://fedoraproject.org/wiki/Updates_Policy#Bodhi_enabling (it now
redirects to that page), and invoked in various other places where
appropriate. The changes freeze policy page -
https://fedoraproject.org/wiki/Changes_Freeze_Policy - is a kind of
'manual redirect' pointing to the other pages, as it's not clear which
one someone who wound up at it would be looking for.
* https://fedoraproject.org/wiki/Releases/Branched was somewhat
overhauled.
* I did a whole ton of smaller stuff as I went through - various pages
got small updates, links were redirected and added (e.g.
https://fedoraproject.org/wiki/Category:Package_Maintainers has rather
more useful links in "Procedures, Policies and Guides" now), etc etc
etc. You can check my Contributions page -
https://fedoraproject.org/w/index.php?title=Special:Contributions/Adamwil...
- for the whole record, and to check my work.
* I also just did a quick blast through the QA space making some updates
here and there - some light touches to pretty much all the 'primary'
pages, QA, QA/Join, the Test Day and release validation SOPs, etc etc.
Again, check my contribution history for the details.
I hope people find these contributions useful and not the contrary! I'm
hoping the Life Cycle page, the Repositories page, and the updated
Package update HOWTO and Package maintenance guide particularly will be
useful for folks, and the more reality-reflecting Updates Policy page
and the new Milestone freezes page will make the freeze process clearer
to people (which was my motivation coming into this whole thing). It all
just seemed like such a damn mess that burning it down, fixing it, and
asking forgiveness seemed like the best plan :) and of course it's a
wiki, so it's not like anything I changed is lost forever.
Thanks folks!
--
Adam Williamson
Fedora QA Community Monkey
IRC: adamw | Twitter: AdamW_Fedora | XMPP: adamw AT happyassassin . net
http://www.happyassassin.net
10:14 p.m.
On Thu, 25 Sep 2014 19:58:19 -0700
Adam Williamson <adamwill(a)fedoraproject.org> wrote:
...snip..
I hope people find these contributions useful and not the contrary!
I'm hoping the Life Cycle page, the Repositories page, and the updated
Package update HOWTO and Package maintenance guide particularly will
be useful for folks, and the more reality-reflecting Updates Policy
page and the new Milestone freezes page will make the freeze process
clearer to people (which was my motivation coming into this whole
thing). It all just seemed like such a damn mess that burning it
down, fixing it, and asking forgiveness seemed like the best plan :)
and of course it's a wiki, so it's not like anything I changed is
lost forever.
Thanks folks!
Thanks for all the editing. ;) I've been trying to watch along in the
wiki rss feed as you have made changes and from a quick glance it all
looks great and much more readable.
kevin
4:32 a.m.
Hi, folks. As I hinted a bit, and as some of you might know from
IRC,
I've spent the last ~24 hours on something of an epic Wiki revision
spree. I made some fairly major and possibly significant changes, so
under the 'ask forgiveness' principle I thought I'd post a quick summary
here.
We forgive you for doing so much of awesome work... :-) Thanks, Adam.
* As already mentioned, the "Change Deadlines" are no more. They are now
"Milestone Freezes". See
https://fedoraproject.org/wiki/Milestone_freezes . (Yeah, I can't decide
on the capitalization). All (I think) significant linking pages have
been updated appropriately. The new page should, I hope, form a useful
and succinct guide to how the milestone freezes actually work.
This page still speaks of deadlines, I assume we should rename it to Alpha/Beta/Final
Freeze instead?
https://fedoraproject.org/wiki/Releases/21/Schedule
5:43 a.m.
----- Original Message -----
> Hi, folks. As I hinted a bit, and as some of you might know from
IRC,
> I've spent the last ~24 hours on something of an epic Wiki revision
> spree. I made some fairly major and possibly significant changes, so
> under the 'ask forgiveness' principle I thought I'd post a quick
summary
> here.
We forgive you for doing so much of awesome work... :-) Thanks, Adam.
>
> * As already mentioned, the "Change Deadlines" are no more. They are now
> "Milestone Freezes". See
> https://fedoraproject.org/wiki/Milestone_freezes . (Yeah, I can't decide
> on the capitalization). All (I think) significant linking pages have
> been updated appropriately. The new page should, I hope, form a useful
> and succinct guide to how the milestone freezes actually work.
This page still speaks of deadlines, I assume we should rename it to
Alpha/Beta/Final Freeze instead?
https://fedoraproject.org/wiki/Releases/21/Schedule
I'm updating it right now, also the big Task Juggler schedule needs
changes (ongoing right now).
Adam,
that had to be crazy night but it's really amazing revamp of the wiki!
Jaroslav
--
devel mailing list
devel(a)lists.fedoraproject.org
https://admin.fedoraproject.org/mailman/listinfo/devel
Fedora Code of Conduct: http://fedoraproject.org/code-of-conduct
5:47 a.m.
----- Original Message -----
----- Original Message -----
> > Hi, folks. As I hinted a bit, and as some of you might know from IRC,
> > I've spent the last ~24 hours on something of an epic Wiki revision
> > spree. I made some fairly major and possibly significant changes, so
> > under the 'ask forgiveness' principle I thought I'd post a quick
summary
> > here.
>
> We forgive you for doing so much of awesome work... :-) Thanks, Adam.
>
> >
> > * As already mentioned, the "Change Deadlines" are no more. They are
now
> > "Milestone Freezes". See
> > https://fedoraproject.org/wiki/Milestone_freezes . (Yeah, I can't decide
> > on the capitalization). All (I think) significant linking pages have
> > been updated appropriately. The new page should, I hope, form a useful
> > and succinct guide to how the milestone freezes actually work.
>
> This page still speaks of deadlines, I assume we should rename it to
> Alpha/Beta/Final Freeze instead?
> https://fedoraproject.org/wiki/Releases/21/Schedule
I'm updating it right now,
Ah, I see - Final was updated by Till, Beta is still change deadline.
Fixing it right now.
also the big Task Juggler schedule needs
changes (ongoing right now).
Adam,
that had to be crazy night but it's really amazing revamp of the wiki!
Jaroslav
> --
> devel mailing list
> devel(a)lists.fedoraproject.org
> https://admin.fedoraproject.org/mailman/listinfo/devel
> Fedora Code of Conduct: http://fedoraproject.org/code-of-conduct
--
devel mailing list
devel(a)lists.fedoraproject.org
https://admin.fedoraproject.org/mailman/listinfo/devel
Fedora Code of Conduct: http://fedoraproject.org/code-of-conduct
11:27 a.m.
On Fri, 2014-09-26 at 06:47 -0400, Jaroslav Reznik wrote:
----- Original Message -----
> ----- Original Message -----
> > > Hi, folks. As I hinted a bit, and as some of you might know from IRC,
> > > I've spent the last ~24 hours on something of an epic Wiki revision
> > > spree. I made some fairly major and possibly significant changes, so
> > > under the 'ask forgiveness' principle I thought I'd post a
quick summary
> > > here.
> >
> > We forgive you for doing so much of awesome work... :-) Thanks, Adam.
> >
> > >
> > > * As already mentioned, the "Change Deadlines" are no more. They
are now
> > > "Milestone Freezes". See
> > > https://fedoraproject.org/wiki/Milestone_freezes . (Yeah, I can't
decide
> > > on the capitalization). All (I think) significant linking pages have
> > > been updated appropriately. The new page should, I hope, form a useful
> > > and succinct guide to how the milestone freezes actually work.
> >
> > This page still speaks of deadlines, I assume we should rename it to
> > Alpha/Beta/Final Freeze instead?
> > https://fedoraproject.org/wiki/Releases/21/Schedule
>
> I'm updating it right now,
Ah, I see - Final was updated by Till, Beta is still change deadline.
Fixing it right now.
Thanks a lot! As I said to Kamil I just wasn't sure if it'd be right to
change the *current* schedule, so I left it up to you.
--
Adam Williamson
Fedora QA Community Monkey
IRC: adamw | Twitter: AdamW_Fedora | XMPP: adamw AT happyassassin . net
http://www.happyassassin.net
11:26 a.m.
On Fri, 2014-09-26 at 05:32 -0400, Kamil Paral wrote:
> Hi, folks. As I hinted a bit, and as some of you might know from
IRC,
> I've spent the last ~24 hours on something of an epic Wiki revision
> spree. I made some fairly major and possibly significant changes, so
> under the 'ask forgiveness' principle I thought I'd post a quick
summary
> here.
We forgive you for doing so much of awesome work... :-) Thanks, Adam.
>
> * As already mentioned, the "Change Deadlines" are no more. They are now
> "Milestone Freezes". See
> https://fedoraproject.org/wiki/Milestone_freezes . (Yeah, I can't decide
> on the capitalization). All (I think) significant linking pages have
> been updated appropriately. The new page should, I hope, form a useful
> and succinct guide to how the milestone freezes actually work.
This page still speaks of deadlines, I assume we should rename it to Alpha/Beta/Final
Freeze instead?
https://fedoraproject.org/wiki/Releases/21/Schedule
My recklessness stopped at the current release schedule - I thought I'd
wait till I saw jreznik, because I'd asked him about the rename in
principle and he was in favour but I hadn't asked if it was OK to do it
for a release in progress. So I was waiting to get the go-ahead from him
before doing that. I see from his later mails that he's done it already
though, so we're all good :)
--
Adam Williamson
Fedora QA Community Monkey
IRC: adamw | Twitter: AdamW_Fedora | XMPP: adamw AT happyassassin . net
http://www.happyassassin.net
11:37 a.m.
----- Original Message -----
On Fri, 2014-09-26 at 05:32 -0400, Kamil Paral wrote:
> > Hi, folks. As I hinted a bit, and as some of you might know from IRC,
> > I've spent the last ~24 hours on something of an epic Wiki revision
> > spree. I made some fairly major and possibly significant changes, so
> > under the 'ask forgiveness' principle I thought I'd post a quick
summary
> > here.
>
> We forgive you for doing so much of awesome work... :-) Thanks, Adam.
>
> >
> > * As already mentioned, the "Change Deadlines" are no more. They are
now
> > "Milestone Freezes". See
> > https://fedoraproject.org/wiki/Milestone_freezes . (Yeah, I can't decide
> > on the capitalization). All (I think) significant linking pages have
> > been updated appropriately. The new page should, I hope, form a useful
> > and succinct guide to how the milestone freezes actually work.
>
> This page still speaks of deadlines, I assume we should rename it to
> Alpha/Beta/Final Freeze instead?
> https://fedoraproject.org/wiki/Releases/21/Schedule
My recklessness stopped at the current release schedule - I thought I'd
wait till I saw jreznik, because I'd asked him about the rename in
principle and he was in favour but I hadn't asked if it was OK to do it
for a release in progress. So I was waiting to get the go-ahead from him
before doing that. I see from his later mails that he's done it already
though, so we're all good :)
And as we're already changing bits during release I'd like to change release
time to use UTC instead of ET. We talked a lot about it but actually - never
committed to it. To make the life easier for US folks, 15:00 UTC (we have
14:00 and 15:UTC mapped to 10 AM ET) should be the time. Talking to Robyduck
trying to figure out time difference each time is sometimes flustrating,
specially as the summer time changes are out of sync. And previously we had
Robyn in the gang with another different timezone without summer time :).
Jaroslav
--
Adam Williamson
Fedora QA Community Monkey
IRC: adamw | Twitter: AdamW_Fedora | XMPP: adamw AT happyassassin . net
http://www.happyassassin.net
--
devel mailing list
devel(a)lists.fedoraproject.org
https://admin.fedoraproject.org/mailman/listinfo/devel
Fedora Code of Conduct: http://fedoraproject.org/code-of-conduct
11:39 a.m.
New subject: Changing release time (was Re: Major wiki revisions:)
On Fri, 2014-09-26 at 12:37 -0400, Jaroslav Reznik wrote:
And as we're already changing bits during release I'd like to
change release
time to use UTC instead of ET. We talked a lot about it but actually - never
committed to it. To make the life easier for US folks, 15:00 UTC (we have
14:00 and 15:UTC mapped to 10 AM ET) should be the time. Talking to Robyduck
trying to figure out time difference each time is sometimes flustrating,
specially as the summer time changes are out of sync. And previously we had
Robyn in the gang with another different timezone without summer time :).
I wouldn't mind, the only issue is that it means the time would be
different with and without summer time (in timezones that have it,
obviously). At least then everyone can use date -u ...
--
Adam Williamson
Fedora QA Community Monkey
IRC: adamw | Twitter: AdamW_Fedora | XMPP: adamw AT happyassassin . net
http://www.happyassassin.net
12:22 p.m.
New subject: Changing release time (was Re: Major wiki revisions:)
On Fri, Sep 26, 2014 at 12:39 PM, Adam Williamson <
adamwill(a)fedoraproject.org> wrote:
On Fri, 2014-09-26 at 12:37 -0400, Jaroslav Reznik wrote:
> And as we're already changing bits during release I'd like to change
release
> time to use UTC instead of ET. We talked a lot about it but actually -
never
> committed to it. To make the life easier for US folks, 15:00 UTC (we have
> 14:00 and 15:UTC mapped to 10 AM ET) should be the time. Talking to
Robyduck
> trying to figure out time difference each time is sometimes flustrating,
> specially as the summer time changes are out of sync. And previously we
had
> Robyn in the gang with another different timezone without summer time :).
I wouldn't mind, the only issue is that it means the time would be
different with and without summer time (in timezones that have it,
obviously). At least then everyone can use date -u ...
That's already the case for people in countries whose daylight savings
transitions aren't aligned with those for EST/EDT in the US. I don't think
too many people would be upset if they have to wait until 11AM to download
a release when 6 months prior they could get it at 10AM, especially since
deadline changes (when they unfortunately, but inevitably occur) tend to
happen on the order of weeks, and mirroring isn't a sub-1hr. activity
either (or downloading, for many people, for that matter).
UTC is much less confusing, and I'm a big fan. +1
15:00 UTC seems reasonable, but I have no preference.
--
Christopher L Tubbs II
http://gravatar.com/ctubbsii
2:41 p.m.
On Thu, 2014-09-25 at 19:58 -0700, Adam Williamson wrote:
Hi, folks. As I hinted a bit, and as some of you might know from
IRC,
I've spent the last ~24 hours on something of an epic Wiki revision
spree. I made some fairly major and possibly significant changes, so
under the 'ask forgiveness' principle I thought I'd post a quick summary
here.
As an encore, this morning I've tweaked
https://fedoraproject.org/wiki/Releases somewhat. There's a more up to
date and I think clearer/better explanation of the Rawhide -> Branched
-> stable process, the stable releases are now up top with development
second, there are links out to the new/newly improved pages from
yesterday, and the mirror links are updated/improved.
I also added a few bits to
https://fedoraproject.org/wiki/Fedora_Release_Life_Cycle , including a
call-out to the Change process and a little tip box explaining that F(N)
development begins at the time F(N-1) branches.
--
Adam Williamson
Fedora QA Community Monkey
IRC: adamw | Twitter: AdamW_Fedora | XMPP: adamw AT happyassassin . net
http://www.happyassassin.net
3519
days inactive
3519
days old
10 comments
5 participants
participants (5)
-
Adam Williamson -
Christopher -
Jaroslav Reznik -
Kamil Paral -
Kevin Fenzi