forrest-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From David Crossley <cross...@apache.org>
Subject Re: merging separate sets of generated docs, default tabs
Date Thu, 17 Mar 2005 00:34:56 GMT
Dave Brondsema wrote:
> 
> Ok.  What about href="/docs"?  I think because it is a 'href' it would
> keep it from failing the build, and it would still be relative.

That should work. I woder why we didn't think of that before.
Maybe it was all getting confused with the separate 0.6 docs.
Dunno. Lets try it.

> Regarding the 2nd change: I removed the project-related tabs from
> docs-author, so that the docs would be completely independent.  This
> lets a user have a local copy of the docs with no broken links; it is
> also like the way the httpd docs are.  Any problem with this?

When the docs are on the website, how will we navigate back to the
Project and Welcome information if there are no tabs.

--David

> David Crossley wrote:
> >This was deliberate. We will eventually need to find a better way
> >to link separate sets of documentation. Apache Cocoon has this
> >same issue.
> >
> >The full URLs is not a proper solution. Apache websites need to be
> >able to be mirrored. For example, this coming weekend all Apache
> >websites are going to fail-over to eu.apache.org while infrastructure
> >work is being done.
> >
> >--David
> >
> >
> >>Author: brondsem
> >>Date: Wed Mar 16 11:27:36 2005
> >>New Revision: 157791
> >>
> >>URL: http://svn.apache.org/viewcvs?view=rev&rev=157791
> >>Log:
> >>these tab links were breaking; point to the full url of the files created 
> >>from docs-author
> >>
> >>Modified:
> >>   forrest/trunk/site-author/content/xdocs/tabs.xml
> >>
> >>Modified: forrest/trunk/site-author/content/xdocs/tabs.xml
> >>URL: 
> >>http://svn.apache.org/viewcvs/forrest/trunk/site-author/content/xdocs/tabs.xml?view=diff&r1=157790&r2=157791
> >>==============================================================================
> >>--- forrest/trunk/site-author/content/xdocs/tabs.xml (original)
> >>+++ forrest/trunk/site-author/content/xdocs/tabs.xml Wed Mar 16 11:27:36 
> >>2005
> >>@@ -35,7 +35,7 @@
> >>
> >>    <tab id="home" label="Welcome" dir=""/>
> >>    <tab id="project" label="Project" dir="" indexfile="contrib.html"/>
> >>-    <tab id="docs" label="Documentation" dir="docs/"/>
> >>-    <tab id="howto" label="How-To" dir="howto/"/>
> >>+    <tab id="docs" label="Documentation" 
> >>href="http://forrest.apache.org/docs"/><!-- change to /docs/0.7 after we

> >>make the 0.7 release and get rid of 0.6 doc structure -->
> >>+    <tab id="howto" label="How-To" 
> >>href="http://forrest.apache.org/howto"/><!-- change to /docs/0.7/howto
-->
> >>
> >></tabs>
> >
> >
> >-------------------------
> >
> >Author: brondsem
> >Date: Wed Mar 16 09:46:03 2005
> >New Revision: 157779
> >
> >URL: http://svn.apache.org/viewcvs?view=rev&rev=157779
> >Log:
> >documentation stands alone, not integrated with the project site
> >
> >Modified:
> >    forrest/trunk/docs-author/content/xdocs/tabs.xml
> >
> >Modified: forrest/trunk/docs-author/content/xdocs/tabs.xml
> >URL: 
> >http://svn.apache.org/viewcvs/forrest/trunk/docs-author/content/xdocs/tabs.xml?view=diff&r1=157778&r2=157779
> >==============================================================================
> >--- forrest/trunk/docs-author/content/xdocs/tabs.xml (original)
> >+++ forrest/trunk/docs-author/content/xdocs/tabs.xml Wed Mar 16 09:46:03 
> >2005
> >@@ -36,8 +36,6 @@
> > <!-- FIXME: FOR-447
> >     <tab id="home" label="Welcome" dir="../../"/>
> > -->
> >-    <tab id="home" label="Welcome" dir="" 
> >indexfile="../../mail-lists.html"/>
> >-    <tab id="project" label="Project" dir="" 
> >indexfile="../../contrib.html"/>
> >     <tab id="docs" label="0.7-dev Documentation" dir="/" 
> >     indexfile="index.html">
> >       <tab id="core" label="Core" indexfile="your-project.html"/>
> >       <tab id="forrestbor" label="ForrestBot" 
> >       indexfile="forrestbot.html"/>

Mime
View raw message