[[e-mail]: Packaging Guidelines Organization]

[Ian Weller]

Pertains to the wiki, moving from f-docs-l to here.

----- Forwarded message from Toshio Kuratomi <a.badger(a)gmail.com&gt; -----

Delivered-To: ianweller(a)gmail.com
Date: Fri, 12 Dec 2008 09:50:22 -0800
From: Toshio Kuratomi <a.badger(a)gmail.com&gt;
User-Agent: Thunderbird 2.0.0.18 (X11/20081119)
To: fedora-docs-list(a)redhat.com
Cc: Tom spot Callaway <tcallawa(a)redhat.com&gt;
Subject: Packaging Guidelines Organization
Precedence: junk
Reply-To: For participants of the Documentation Project
<fedora-docs-list(a)redhat.com&gt;
Errors-To: fedora-docs-list-bounces(a)redhat.com

Howdy folks,

I'm on the Fedora Packaging Committee and we are in desperate need of
some docs help.

We manage the Packaging Guidelines which help packagers and reviewers
create quality packages for Fedora.  Unfortunately, as time has
progressed the Guidelines have grown larger and larger in an "organic"
fashion.  In order to keep the policies managable for people new to
Fedora we need to organize them somehow.  There's several threads in this:

1)
We want something that helps the packager and reviewer find all the
Guidelines that apply to the package that they are working on but not to
the ones they are not.  So we need some sort of navigation based on
questions the packager and reviewer can answer about the packages:

General Review Items

What programming languages is this written in?

Is this a library or an application?

2)
We want to have a checklist of items to look at with more in-depth
information about why a Guideline exists available to those who want to
know more.

3)
Some of our extra information is more HOWTO-oriented.  For instance, the
section on Package Naming talks about how to choose a name for a package
and how to structure the version strings so that they are always upgradable.

If we could get someone to help us work out this restructuring I'm here
to work on these things from the FPC side.  Feel free to contact me via
this list, email, fedora-packaging-list, or on IRC: abadger1999
(#fedora-devel, #fedora-admin).

-Toshio




-- 
fedora-docs-list mailing list
fedora-docs-list(a)redhat.com
To unsubscribe: 
https://www.redhat.com/mailman/listinfo/fedora-docs-list

----- End forwarded message -----

-- 
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 Fri, Dec 12, 2008 at 11:14:28PM -0600, Ian Weller wrote:
>  Pertains to the wiki, moving from f-docs-l to here. 
Not sure about that.  This is a document that happens to live in the
wiki, but I suggested to Toshio f-docs-l for updates to the Packaging
Guide because ...

* It lives under access control, so would need to move to a CMS or
  other locked publishing system.

* It isn't really a hugely living set of content with constant
  updates; the Packaging Committee updates it regularly but could do
  it with some content management workflow involved.

* It needs to be translated, and it really needs that within our best
  translation system -- PO files and Transifex.  DocBook XML is a
  great way to do this, and it happens to work well with the more
  irregular update schedule the document needs.

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