[EMAIL PROTECTED] wrote:
>
> Pier,
>
> I am a bit confused now. I thought the module 'xml-site' was on its way to
> getting obsolete. The place where I have been recommended to pick up the
> latest styles from is, 'xml-stylebook' not 'xml-site'. This probably makes
> sense for some of us because all sources files for a project, which include
> the source XML documentation, would then reside togehter under the same
> directrory as the module. If we keep XML source files outside (under
> xml-site), then people who get the *source drop* will miss out on the XML
> documentation which is also part of the source.
The styles in xml-site and in xml-stylebook are the same ones. If you
make a change there, you get a change also in the other module.
> This however brings up another issue - that of integrating the entire
> xml.apache.org website and creating it in one shot, a convenience we have
> if we keep all XML docs under xml-site. But as I realized later on, this is
> not such a big drawback since you can always create the HTML docs (by
> invoking java and Stylebook) by pointing it to the 'xml-stylebook'
> directory. So essentially the recommended structure looked cleaner to me
> since, projects can keep their entity files separate (earlier structure had
> Java and C entities together in one file), and someone who does not want to
> deal with the intricacies of Stylebook can invoke it like a black-box by
> just pointing to the right directory.
Exactly... That's why I am willing to get the primary repositories of
XML documents in the subprojects modules... And from there to have a
link in xml-site when things need to go "live"...
> The Xerces-Java and Xerces-C already have started following this scheme,
> (Xerces-Perl is next). But I do not know how far Xalan and the other folks
> have gone in this direction. Lets decide on something and fix it once and
> for all.
ok... so all the documentation is now in the project modules? all the
updated ones are there? good. I just need to know it...
Pier
--
--------------------------------------------------------------------
- P I E R -
stable structure erected over water to allow the docking of seacraft
<mailto:[EMAIL PROTECTED]> <http://www.betaversion.org/~pier/>
--------------------------------------------------------------------
- ApacheCON Y2K: Come to the official Apache developers conference -
-------------------- <http://www.apachecon.com> --------------------
