On Mon, 9 Jul 2001, Jon Stevens wrote:
> on 7/7/01 9:33 AM, "Craig R. McClanahan" <[EMAIL PROTECTED]> wrote:
>
> > FWIW, I'm fine with Anakia, XSLT, Cocoon, Stylebook, Docbook, or whatever
> > ... but IF AND ONLY IF the tags for use by the document authors are well
> > documented, and the page
On Tue, 10 Jul 2001, GOMEZ Henri wrote:
> >Craog
> >> I have a feeling that whatever is the same will be a lot of
> >piecemeal here
> >> and there, excluding of course, web-app documentation. So
> >far yourself,
> >> Pier, and Henri are the only three TC developers to post
> >their position o
>Craog
>> I have a feeling that whatever is the same will be a lot of
>piecemeal here
>> and there, excluding of course, web-app documentation. So
>far yourself,
>> Pier, and Henri are the only three TC developers to post
>their position on
>> that (re: inter-version relevancy).
Pier and I
on 7/7/01 9:33 AM, "Craig R. McClanahan" <[EMAIL PROTECTED]> wrote:
> FWIW, I'm fine with Anakia, XSLT, Cocoon, Stylebook, Docbook, or whatever
> ... but IF AND ONLY IF the tags for use by the document authors are well
> documented, and the page generation procedure is amenable to Ant scripting
>
>
> "Developer" in the sense of this sentence is a Tomcat
> developer. "User" is the people that just want to download, install,
> configure, and utilize Tomcat as a servlet container.
>
Agree. That's why I suggested that we need to separate Developer Guide from
User/Administrator Guide. I be
On Sat, 7 Jul 2001, Aaron Bannert wrote:
> On Sat, Jul 07, 2001 at 09:25:46AM -0700, Craig R. McClanahan wrote:
> > Yes, we obviously need pointers in a top-level README on "where the docs
> > went".
>
> I'm willing to collaborate on these types of docs. On a slight tangent,
> I'd like to poin
On Sat, 7 Jul 2001 [EMAIL PROTECTED] wrote:
> On Fri, Jul 06, 2001 at 10:06:21PM -0700, Craig R. McClanahan wrote:
> >
> > * Docs should live in the source tree of the project that they
> > are about. Although Henri's suggestion for jakarta-tomcat-docs
> > is noble, what you'll find in pr
On Sat, 7 Jul 2001, Rob S. wrote:
> Unfortunatly, I won't be able to participate much in this discussion this
> weekend since i know *0* about AWT and the Java cert (Monday morning, 9am)
> apparently thinks you should =) Sorry all...
>
> > The important issue is *not* what transformation tool
On Sat, 7 Jul 2001, Rob S. wrote:
> > Providing Tomcat documentation in a WAR file is a little like providing
> > a VHS tape on how to setup your VCR. It may seem really elegant to have
> > on-the-fly style-generating documentation, and I may be alone on this,
> > but I think that the majority
Unfortunatly, I won't be able to participate much in this discussion this
weekend since i know *0* about AWT and the Java cert (Monday morning, 9am)
apparently thinks you should =) Sorry all...
> The important issue is *not* what transformation tool is used. The
Oh, by "works for Catalina" I w
On Mon, 2 Jul 2001, Rob S. wrote:
> > We've started writing some new docs in XML (catalina/docs/dev/xdocs). The
> > HTML generation is done with XSL, but the DTD should be the same
> > as the one
> > used by Anakia.
>
> I noticed the xdocs directory, but I didn't see anything in there. I sent
On Mon, 2 Jul 2001, Rob S. wrote:
> This seems to be one of the questions that comes up and never gets answered
> (re: docs, not Jon's behavior ;) I'm not sure what magical solution will
> get people to read docs. Frankly, I'd just like to get started. Anakia
> works for Jakarta,
Yep, thank
On Mon, 2 Jul 2001, Jon Stevens wrote:
> on 7/2/01 5:58 PM, "Pier P. Fumagalli" <[EMAIL PROTECTED]> wrote:
>
> > Excellent :) Anakia is a tool written by Jon to translate XML into HTML
> > (correct me if I'm wrong) based on the same language that WebMacro uses...
> > It generates http://jakart
On Tue, 3 Jul 2001, Jon Stevens wrote:
> > It's just sad when an organization like Apache chooses to ignore existing
> > standards and invent it's own DTD and transformation language to do the
> > site.
>
> Once again Costin, you fail to impress me with your statements. You confuse
> "Apache" wit
"Geir Magnusson Jr." wrote:
>
> This is deja vu all over again. We should take one copy if this
> discussion (we had the same thing in Commons, and I am sure it happened
> everywhere else...), post it somewhere, and people can just submit
> article numbers or something rather than typing the sa
Docbook is a standard for writing books, articles, technical
documentations. It is the format used by LDP ( linux doc project ) and
many ( or most ) open source projects, companies, etc. ( it's not a new
thing, has been around since SGML days ).
XSLT is the W3C standard for XML transformation.
sday, July 03, 2001 11:12 AM
> To: [EMAIL PROTECTED]
> Subject: Re: [PRE-PROPOSAL] jakarta-tomcat-doc sub-project : WAS:
> [TomcatDocumentation Redactors To Hire]
>
>
> On Mon, 2 Jul 2001, Si Ly wrote:
>
> > I submitted a very simple patch last week, and I haven
on 7/3/01 8:04 AM, "Justin Erenkrantz" <[EMAIL PROTECTED]> wrote:
> On Mon, Jul 02, 2001 at 07:38:55PM -0700, Si Ly wrote:
>> I submitted a very simple patch last week, and I haven't heard from
>> anyone about it. It seems to me that "outsiders" (non-committers)
>> can't get anything into CVS be
>The patch is good, if nobody else get to submit it I'll do that when I
>return ( and start again on jasper - I just want to make sure the
>connector is in good state so we can finally have the beta ).
If Costin agree with the patch, I'll commit them
On Mon, 2 Jul 2001, Si Ly wrote:
> I submitted a very simple patch last week, and I haven't heard from
> anyone about it. It seems to me that "outsiders" (non-committers)
> can't get anything into CVS because the committers are not looking at
> the patches, for whatever reasons.
Sorry about tha
On Mon, Jul 02, 2001 at 07:38:55PM -0700, Si Ly wrote:
> I submitted a very simple patch last week, and I haven't heard from
> anyone about it. It seems to me that "outsiders" (non-committers)
> can't get anything into CVS because the committers are not looking at
> the patches, for whatever reas
>I submitted a very simple patch last week, and I haven't heard from
>anyone about it. It seems to me that "outsiders" (non-committers)
>can't get anything into CVS because the committers are not looking at
>the patches, for whatever reasons.
The commiters look at patches but may take time to ap
On Tue, Jul 03, 2001 at 03:02:43AM +0100, Pier P. Fumagalli wrote:
> > Documentation is just as valuable as the software...
>
> Probably even more... It allows more dummies to install our software, more
> dummies = more bugs found, more bugs found = more fixes, more fixes = better
> software... O
>Probably even more... It allows more dummies to install our
>software, more
>dummies = more bugs found, more bugs found = more fixes, more
>fixes = better
>software... Or that's right only in f**ked up mind? :)
>
>Pier
+1
Geir Magnusson Jr. at [EMAIL PROTECTED] wrote:
>
> Documentation is just as valuable as the software...
Probably even more... It allows more dummies to install our software, more
dummies = more bugs found, more bugs found = more fixes, more fixes = better
software... Or that's right only in f**k
Brad Cox wrote:
>
> At 10:09 AM -0400 7/2/01, Rob S. wrote:
> >1) Developers don't write them in lieu of coding.
> >2) Users don't read them
> >3...) ?
>
> http://www.c2.com/cgi-bin/wiki has a novel way of getting at the
> problem. Not a panacea obviously, but what is? The one at that
> address
This is deja vu all over again. We should take one copy if this
discussion (we had the same thing in Commons, and I am sure it happened
everywhere else...), post it somewhere, and people can just submit
article numbers or something rather than typing the same arguments over
and over.
"Yes, I kno
On Mon, 2 Jul 2001, Rob S. wrote:
> > I'm not sure I understand that. There are plenty of HTML editors, and 99%
> > of the people on this list know a bit of html. Nobody asked for "good
> > looking" documentation or cool formats, the content is missing.
>
> Agreed, but using Note/Text/Whatever/Pa
28 matches
Mail list logo