maven-doxia-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Paul Spencer <>
Subject Re: Preparation of Doxia 1.0-beta-1 release
Date Mon, 08 Dec 2008 13:26:48 GMT

On Dec 8, 2008, at 7:37 AM, Vincent Siveton wrote:

> 2008/12/8 Paul Spencer <>:
>> On Dec 8, 2008, at 7:17 AM, Vincent Siveton wrote:
>>> 2008/12/8 Lukas Theussl <>:
>>>> I just noticed that the fml module now takes ~5min to build  
>>>> instead of a
>>>> few
>>> Same for xdoc module.
>>>> secs for all other modules. There are some svn checkouts during  
>>>> testing,
>>>> are
>>>> those necessary? Does it mean you can't build doxia off-line?
>>> The tests are to perform XSD validations under our current
>>> documentation. Since we add new XSD files in this release, I think
>>> these tests are useful.
>>> About off-line build, we need to be sure that latest Maven doc is
>>> again valid (and BTW doxia needs external dependencies)
>>> Instead of svn co, we could link to relative doc path, ie from
>>> doxia-module-fml using ../../../plugins/maven-ant-plugin/src/site
>>> This approach has pros/cons like svn co.
>>> WDYT?
>> Why are you not using a dependency? A "svn co" does not insure a
>> reproduceable build.
> Using a separate dependency or a given test folder insures that the
> documentation is valid, right.
> But how to be sure that the *latest* doc is still valid under our xsd?
> Is it a reasonable test case?

I am not sure the best way to insure the documentation is in sync.   
The "snippet" macro from a test case is one tool.  The test cases can  
verify the XSD "matches" the doc.  I say "matches" because it does not  
verify the documentation is in sync with the test case.

> Vincent

Paul Spencer

View raw message