Thanks for the info Ted. By the way, Chapter 0 "Usual suspects" is missing from Struts 1.x user's guide [1], is this intentional?
[1] http://struts.apache.org/1.x/userGuide/index.html On 7/17/06, Ted Husted <[EMAIL PROTECTED]> wrote:
I think the href's might be left over from our pre-Maven XML's. The "xdoc" format for Maven 2 is supposed to be the same as Maven 1, which in turn was taken from the Jakarta "Anakia" format. * http://maven.apache.org/maven-1.x/using/site.html We weren't an Anakia site back then. We used Ant and some of our own stylesheets. My recollection is that the formats were similar but different. I suspect that if we want the bookmarks, we will have to use <a name=/> tags. If someone wanted to patch Maven, I'd suggest generating the bookmarks automatically, the way Confluence does. I'd also consider taking the outline numbers out of the user guide, since create extra maintenance. If we roll our own bookmarks, we might want to express a guideline as to the format. We've used various formats in various places at various times over the years. We might want to add a documentation guidelines section to the end of the Release Guidelines. There are a few guidelines in place for the s2 wiki, but they are targetted for Confluence. * http://confluence.twdata.org/display/WW/Documentation+Style+Guide As far as the docs and the codebase go, the 1.3.5 version is tagged, and so people should feel free to move forward. -Ted. On 7/17/06, Michael Jouravlev <[EMAIL PROTECTED]> wrote: > I guess this issue is Maven-related. If chapter is declared using > "href" for links, links are not generated in HTML. For example: > > <subsection name="Prerequisite Software" href="Prerequisites"> > > produces the following HTML, notice that there is no link: > > <div class="section"><h3>Prerequisite Software</h3> > > There are other chapters that define links using standard "A" tag, they do work: > > <a name="request_processor"/> > <subsection name="4.2.1 Request Processor"> > > produces the following HTML: > > <a name="request_processor"></a> > <div class="section"><h3>4.2.1 Request Processor</h3> > > So either Maven should be fixed to generate links for "href" > attribute, or all chapters should be named using "A" tag. I hope the > former option is possible ;) > > --------------------------------------------------------------------- > To unsubscribe, e-mail: [EMAIL PROTECTED] > For additional commands, e-mail: [EMAIL PROTECTED] > > -- HTH, Ted. * http://www.husted.com/struts/ --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
