This is a change to the http://fedoraproject.org/wiki/Packaging:NamingGuidelines it was originally posted to the Talk page there and I'm reposting it here for discussion and voting

The two "Upgrade path example" listings (for mozilla and alsa-lib) in the Release Tag section strike me as confusing. In every other list of NVRs given as an example, the text in parentheses that follows each entry is a description of that NVR. For the two upgrade path examples, even though they're formatted in exactly the same way, the text in parentheses effectively describes the NVR on the ''following'' line.

I had to read through it twice to catch on to that. On first read I thought I'd just spotted typos in some of the tags, because the entries didn't seem to match "their" descriptions. I don't know if the parenthetical descriptions in these examples should all be shifted downwards by one line, or if the formatting should be changed to make it much more obvious that these two lists are different from all of the others, but either of those changes would enhance clarity a great deal. --[[User:Ferdnyc|Ferdnyc]] 13:07, 22 June 2011 (UTC)

Well, after 5 months without comment on this, I decided to take a page from Wikipedia and "be bold". So, I undertook a re-working of the descriptions in the two Upgrade Path examples I mentioned. In the process, I ended up eliminating the giant <PRE>s and wikifying the whole works. (All because I wanted to use links in the descriptions! LOL.)

:Since I can't edit this page, my proposed replacement for http://fedoraproject.org/wiki/Packaging:NamingGuidelines#Pre-Release_packages can be found at http://fedoraproject.org/wiki/User:Ferdnyc/PackagingEditTest. The full source code of that page should be a drop-in replacement; I tried to preserve the structure to make things as easy as possible should anyone wish to adopt my changes.

There shouldn't be any content changes (other than the explanation texts in the two Upgrade Path examples), just lots of formatting tweaks. I'm still not happy about how the table captions look -- I'd prefer they be left-justified rather than centered, I think. Other than that, it seems pretty serviceable to me... but I'm biased. http://fedoraproject.org/wiki/User:Ferdnyc/PackagingEditTest, submitted for your consideration. ;-)

--[[User:Ferdnyc|Ferdnyc]] 09:09, 23 November 2011 (UTC)