josemanimala at gmail.com
Sat Jun 9 05:11:45 UTC 2007
On 6/8/07, Karsten Wade <kwade at redhat.com> wrote:
> On Sat, 2007-06-02 at 09:51 +0530, jose manimala wrote:
> > i am really interested in the rpm guide. i'd like to help
> > maintain it. i've been using rpm and have almost used all of the
> > feautres it has, i know everyone has. but since its up there on the
> > list and someone is needed to maintain it i am here. So just let me
> > know. i might need some guidance to get started!!
> Ah, yes, the RPM Guide. What a fantastic task to work on! It is an
> already-to-go guide in XML.
> Even if you are familiar with the pieces of CVS, XML, and DocBook, it is
> worth having a look through the IRC log posted today:
> You can check out the guide from CVS, it is the 'rpm-guide' module. It
> *may* need an update to match the current toolchain. We should also
> make an alias of 'rpm-guide-devel' as just the development branch.
> OK, but what about a team to work on it? There are two considerations:
> 1. What is going on upstream at rpm.org? Do they want to help
> contribute? Do they want to make this a part of the actual SRPM for rpm
Hey they have listed it there for development.?
Exact quote: " A more recent book by Eric Foster-Johnson, this has
recently been released under the Open Publication License and a draft
close to the published version is available. Participation in
updating the Guide can be done via the Fedora Documentation Project.
Discussions about moving this content and work upstream to rpm.org can
occur on fedora-docs-list."
I guess we can work on it dont you think. They are not planning on
anything i guess.
> 2. How to get started and attract a team?
> I do not know the answer to the first question/consideration. There are
> some rpm.org folks here, if they can speak up; if you know who they are,
> please point their attention here for this discussion. More below ...
> As for the second question/consideration, that is an easy answer: just
> get started. Once you know where to start (in cvs.fedoraproject.org or
> $VCS.rpm.org) ...
> 1. Just start.
> 2. Open the document files
> - start listing what needs to be changed
> - change stuff you know needs fixing
> 3. Commit early and often
> - use verbose commit messages explaining *why* you changed content
> (since the "what was changed" is in the CVS diff).
> 4. Ask questions on this mailing list
> 5. Before you realize it, two or three other dedicated people will
> materialize. Just like that.
I am starting out on the work on it. will put up a list of changes soon!!
> More about upstream/downstream for the RPM Guide ...
> I'm not saying we toss the RPM Guide to rpm.org, "Here, this is your
> problem now." I'm pausing to consider where the best home for the
> source document should be. Once we have that figured out, we can
> resolve the technical situation. Remember -- Fedora is made up of
> thousands of packages that come from an upstream. Why not the same with
> the content?
> Anyway, it doesn't hurt to think about the connection.
Well develop the document... i think fedora is the best home for it
because of th large number of contributors and people involved!!
> - Karsten
> Karsten Wade, 108 Editor ^ Fedora Documentation Project
> Sr. Developer Relations Mgr. | fedoraproject.org/wiki/DocsProject
> quaid.108.redhat.com | gpg key: AD0E0C41
> ////////////////////////////////// \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\
> fedora-docs-list mailing list
> fedora-docs-list at redhat.com
> To unsubscribe:
Jose M Manimala
S6 Computer science and engineering
Rajagiri School Of Engineering And Technology
More information about the docs