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
-- fedora-docs-list@xxxxxxxxxx To unsubscribe: http://www.redhat.com/mailman/listinfo/fedora-docs-list
