incubator-general mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From David Crossley <cross...@apache.org>
Subject Re: Incubator site status wrt a move to Anakia?
Date Wed, 25 Jan 2006 07:56:07 GMT
It is time to make a plan for the move to Anakia.
We cannot afford for it to drag on any longer.

---------------
1) Review the generated source documents in site/xdocs2

Did the transformation perform okay?

http://svn.apache.org/repos/asf/incubator/public/trunk/site/README.txt

---------------
2) Refine the stylesheet

site/xdocs2/stylesheets/site.vsl

Seen only one problem so far. It needs to handle
more than two levels of subsection.

This can be fixed later.

---------------
3) Add any missing links to side-panel

For example, the new documents for the old "Learn" tab
are in site/xdocs2/learn but are not yet linked into
the site/xdocs2/stylesheets/project.xml

This can be fixed later.

---------------
4) Fix some things in site-author

At the moment these are not being processed by forrest
because they are not linked into the site.

jcms.html exists only in site-publish/projects
i.e. no matching source in site-author/projects

mv projects/sandesha.cwiki ip-clearance + link to table.
mv projects/wss4j.cwiki ip-clearance + link to table.

None of the harmony-* docs are linked into the
ip-clearance table.

These links must exist or the docs will not be converted.
Help please.

---------------
5) Generate the final new xdocs 

---------------
6) Set up the svn space

incubator/public/trunk = top-level

Install Anakia at this top-level, i.e. move the
relevant contents of the new "site" directory up to
this top level, i.e. its build.xml and lib directory.

So the layout will be:

README.txt
STATUS
build.xml ... relace old not-used file with site/build.xml
lib ... the Anakia libraries
site-author ... replaced with the new source docs
site-publish ... the new Anakia-generated docs

---------------
7) Replace the existing content

In site-author

Retain the svn history. Do 'svn move' each file
to have a .xml filename extension and then replace
the content with that of the new sources from the
site/xdocs2 directory.

---------------
8) Generate the new html docs

---------------
9) Clean up the site-publish diectory

e.g. remove all the *.pdf
e.g. remove the corner images and CSS, etc.

---------------
10) Fix the website

This should not need to change. It will still be
an 'svn update' of the "site-publish" directory
as is done now.

It is important to keep it that way, because i supsect
that there is some extra content in there that is
not generated by the docs system.

---------------
11) Further tidy of site-author

Deal with some content that is not supposed to be there,
e.g. sub-directories: activemq, agila, servicemix,
geronimo, harmony, tapestry

See various past requests to general@ list.

---------------
12) Explain how to use the Anakia-based system

Replace the content at i.a.o/guides/website.html

---------------

If there are no concerns about that, then i will
go ahead early next week, i.e. 30/31 January.

I would like assistance with steps 1, 2, and 4.
Someone can attend to 3 and 11 later.

-David

---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Mime
View raw message