Packaging Guidelines

[Susan Lauber]

Greetings all - especially the packaging folks,

I talked to a few people at FUDCon and the end result is that I seem to be
the Docs Project lead for the Packaging Guidelines docs.
I think it will be an exciting task and I hope to learn a lot about the Docs
Project as well as more about building packages in the process.

I have begun the wiki page renaming for the pages in the (new) Packaging
namespace by creating a PSV file in
http://git.fedoraproject.org/git/wikirename.git

It contains the existing names and my first pass at suggestions for new
names.

I am hoping that members of the Packaging Guidelines team can answer a fee
questions for me:

1. There are a number of meeting minutes and IRC log pages.  Do these really
need to be in the Packaging namespace (with a Category of Meeting Minutes)
or should they be moved to the Meetings namespace (with a Category of
Packaging)?
note: you can have many categories but only one namespace per page.
Meetings namespace is not searched by default.  Packaging namespace has
extra access controls.

2. The file [[Packaging:OldJPackagePolicy]] has a warning at the top about
being out of date (*Last Revised:* Monday Feb 12, 2007).  Can this go into
the Archive namespace?  As I understand it we traditionally leave the old
name the same when that happens.  If not, I will rename it in a way that
helps identify it as old.

3.  The next step is Categories for the pages.  Which may also help with any
additional renaming. Are there any suggestions or ideas already out there
before I start making them up - er - examining content for logical category
names?

I've got more - but these will get me started. :)

Thanks,
Susan


-- 
Susan Lauber, (RHCX, RHCA, RHCSS)
Lauber System Solutions, Inc.
http://www.laubersolutions.com
gpg: 15AC F794 A3D9 64D1 D9CE  4C26 EFC3 11C2 BFA1 0974

[Ian Weller]

On Wed, Jan 14, 2009 at 07:48:11PM -0500, Susan Lauber wrote:
>  1. There are a number of meeting minutes and IRC log pages.  Do these
> really
>  need to be in the Packaging namespace (with a Category of Meeting Minutes)
>  or should they be moved to the Meetings namespace (with a Category of
>  Packaging)?
>  note: you can have many categories but only one namespace per page.
>  Meetings namespace is not searched by default.  Packaging namespace has
>  extra access controls.
>   
I think they ought to go into Meeting: solely because of search
purposes. In addition, why would there need to be any extra limits on
who can edit the meeting pages? It's the same sort of thing with any
other meeting, right?

>  2. The file [[Packaging:OldJPackagePolicy]] has a warning at the top
> about
>  being out of date (*Last Revised:* Monday Feb 12, 2007).  Can this go into
>  the Archive namespace?  As I understand it we traditionally leave the old
>  name the same when that happens.  If not, I will rename it in a way that
>  helps identify it as old.
>   
Theoretically these should go in Archive. Not sure what to do about ACLs
though.

>  3.  The next step is Categories for the pages.  Which may also help
> with any
>  additional renaming. Are there any suggestions or ideas already out there
>  before I start making them up - er - examining content for logical category
>  names?
>   
;)

Special:AllPages with the Categories namespace filter might help you
find existing categories.

-- 
Ian Weller <ianweller(a)gmail.com&gt;                  http://ianweller.org
GnuPG fingerprint:  E51E 0517 7A92 70A2 4226  B050 87ED 7C97 EFA8 4A36
"Technology is a word that describes something that doesn't work yet."
  ~ Douglas Adams

[Karsten Wade]

On Wed, Jan 14, 2009 at 07:48:11PM -0500, Susan Lauber wrote:
>  Greetings all - especially the packaging folks,
>  
>  I talked to a few people at FUDCon and the end result is that I seem to be
>  the Docs Project lead for the Packaging Guidelines docs.
>  I think it will be an exciting task and I hope to learn a lot about the Docs
>  Project as well as more about building packages in the process. 
Thanks Susan.  I think this guide is one of the most important content
pieces for Fedora today and the future; we are nothing if not at least
set of well-built packages.

>  I have begun the wiki page renaming for the pages in the (new)
> Packaging
>  namespace by creating a PSV file in
>  http://git.fedoraproject.org/git/wikirename.git 
My one suggestion, which we discussed on IRC, was to use lower case
for subsequent words in a title.  In other words, [[Titles have a
natural flow]], reserving all-initial caps for [[Really Important
Chapters of Stuff]].  This is from:

https://fedoraproject.org/wiki/Help:Wiki_structure#General_naming_rules

>  3.  The next step is Categories for the pages.  Which may also help
> with any
>  additional renaming. Are there any suggestions or ideas already out there
>  before I start making them up - er - examining content for logical category
>  names? 
For the rest of the audience here :), categories are where we get our
information nesting.  [[Category:Python packaging guidelines]] can be
applied to >1 pages, creating an instant reference of anything to do
with packaging Python.  Categories can be nested in each other, and
across each other, to create organic and intentional pathways for
people to follow.

- Karsten
-- 
Karsten 'quaid' Wade, Community Gardener
http://quaid.fedorapeople.org
AD0E0C41

[Dale Bewley]

On Wed, 2009-01-14 at 19:48 -0500, Susan Lauber wrote:
>  Greetings all - especially the packaging folks,
>  
>  I talked to a few people at FUDCon and the end result is that I seem to be the Docs
> Project lead for the Packaging Guidelines docs. 
Funny, I was just reading these guidelines today, and I was just about
to suggest that this page be removed
https://fedoraproject.org/wiki/PackagingHints

All that content is found in a more up to date form at
https://fedoraproject.org/wiki/Packaging/Guidelines

What is the procedure for deleting a page from the wiki?

[Ian Weller]

On Wed, Jan 14, 2009 at 06:21:56PM -0800, Dale Bewley wrote:
>  What is the procedure for deleting a page from the wiki?
>   
A damn good reason on why you aren't creating a redirect and telling me
is required. :)

Seriously though, there are no deletions, there are only redirects.
Unless it's a *really* good reason.

https://secure.wikimedia.org/wikipedia/meta/wiki/Help:Redirect

-- 
Ian Weller <ianweller(a)gmail.com&gt;                  http://ianweller.org
GnuPG fingerprint:  E51E 0517 7A92 70A2 4226  B050 87ED 7C97 EFA8 4A36
"Technology is a word that describes something that doesn't work yet."
  ~ Douglas Adams

[David Nalley]

On Wed, Jan 14, 2009 at 9:21 PM, Dale Bewley <dlbewley(a)lib.ucdavis.edu&gt; wrote:
>  On Wed, 2009-01-14 at 19:48 -0500, Susan Lauber wrote:
> > Greetings all - especially the packaging folks,
> >
> > I talked to a few people at FUDCon and the end result is that I seem to be the Docs
> Project lead for the Packaging Guidelines docs.
>
>  Funny, I was just reading these guidelines today, and I was just about
>  to suggest that this page be removed
>  https://fedoraproject.org/wiki/PackagingHints
>
>  All that content is found in a more up to date form at
>  https://fedoraproject.org/wiki/Packaging/Guidelines
>
>  What is the procedure for deleting a page from the wiki? 

https://fedoraproject.org/wiki/How_to_delete_a_wiki_page