[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]

CVS problem



Ahoy there doc'ers,

Elliot had a problem with our CVS organization as-is, and Karsten
thought it was a good idea[1] to float this by the list.  He, and
presumably other Fedora developers with similar setups -- and I am
assuming he is not the only one -- need an organization for our included
CVS bits (xsl/, common/, etc.) that is not going to clash with their
other environments.

Elliot suggested simply subordinating these to a separate folder, which
we could name appropriately.  Some suggestions included docs-setup/ and
docs-common/.  This would mean there would now be docs-setup/xsl/, and
so forth.  The Makefile we use would have to be patched appropriately,
of course.

Also at issue is the way people get these bits.  When we originally put
up the docs-setup module, the assumption was made that we would not be
changing this stuff very much.  However, the last couple of months have
shown that is not the case[2,3], as there have been quite a number of
commits there, including:

* chunking XSL changes
* additional/changed XML entities for:
  - legal notice
  - draft & legacy notices
  - relnotes
* CSS changes for HTML rendering

In light of the pace of these changes, and the fact that there are more
on the horizon, I think we should re-examine requiring people do
separate checkouts of a docs-setup module.  I believe Karsten agreed
with me, so he can pitch in here if desired.  It would be great if the
docs-setup/ stuff simply came down on the same level with the my-
tutorial/ folder, rather than subordinate (my-tutorial/docs-setup/),
since the latter implies multiple redundant copies for people working on
lots of docs.  Focus should be on ease of use for the user (who is not
necessarily a developer), maintainability, and maybe other factors I'm
forgetting.

So, let's open the floor for suggestions and input....

[1] http://www.redhat.com/archives/fedora-dsco-list/2005-
June/msg00011.html
[2] http://www.redhat.com/archives/fedora-docs-commits/2005-
May/thread.html
[3] http://www.redhat.com/archives/fedora-docs-commits/2005-
June/thread.html

-- 
Paul W. Frields, RHCE                          http://paul.frields.org/
  gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233  5906 ACDB C937 BD11 3717
 Fedora Documentation Project: http://fedora.redhat.com/projects/docs/

Attachment: signature.asc
Description: This is a digitally signed message part


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]