You are viewing a plain text version of this content. The canonical link for it is here.
Posted to ojb-dev@db.apache.org by Armin Waibel <ar...@apache.org> on 2004/04/09 15:17:51 UTC
Re: [proposal] Using Forrest to generate docu
Hi all,
I played a little bit with Forrest and generate an "early alpha" version
of the OJB webpage. Have a look at this:
http://www.powaibel.de/ojb/index.html
Most pages are corrupted (+pdf-files missing), because the xml-files are
not ported to Forrest. Only the main page and FAQ are correct.
The port of the xdocs files shouldn't be a problem. This can be done in
a few days. I only have problems with the Forrest configuration. Does
someone has experience in using Forrest?
regards,
Armin
Mahler Thomas wrote:
> +1 to try out forest!
>
>
>>-----Original Message-----
>>From: Armin Waibel [mailto:arminw@apache.org]
>>Sent: Tuesday, March 30, 2004 8:15 PM
>>To: OJB Developers List
>>Subject: [proposal] Using Forrest to generate docu
>>
>>
>>Hi all,
>>
>>I would propose to change the tool for web-site/documentation
>>generation. Currently Thomas use Maven to the job, but Maven
>>is hard to
>>handle and has less documentation. Further on Maven corrupt (or we do
>>something wrong) some of the html-sites, e.g. see
>>http://db.apache.org/ojb/query.html#report%20queries
>>
>>Yesterday I had a first look on Forrest (latest from SVN).
>>It's really
>>impressing, many things will be handled automatic. Forrest
>>generates an
>>side-summary (index) at the beginning of each page (currently
>>we do this
>>by hand), an pdf-file for each site (I think one big pdf for
>>the whole
>>web-site was currently not supported), checks for broken links, ...
>>
>>I don't have experience in other documentation frameworks, so
>>I can't do
>>comparisons, anyway it looks fine.
>>
>>What do you think?
>>
>>regads,
>>Armin
>>
>>---------------------------------------------------------------------
>>To unsubscribe, e-mail: ojb-dev-unsubscribe@db.apache.org
>>For additional commands, e-mail: ojb-dev-help@db.apache.org
>>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: ojb-dev-unsubscribe@db.apache.org
> For additional commands, e-mail: ojb-dev-help@db.apache.org
>
>
>
---------------------------------------------------------------------
To unsubscribe, e-mail: ojb-dev-unsubscribe@db.apache.org
For additional commands, e-mail: ojb-dev-help@db.apache.org
Re: [proposal] Using Forrest to generate docu
Posted by Brian McCallister <mc...@forthillcompany.com>.
Ooo, pretty.
=)
-Brian
On Apr 9, 2004, at 9:17 AM, Armin Waibel wrote:
> Hi all,
>
> I played a little bit with Forrest and generate an "early alpha"
> version of the OJB webpage. Have a look at this:
>
> http://www.powaibel.de/ojb/index.html
>
> Most pages are corrupted (+pdf-files missing), because the xml-files
> are not ported to Forrest. Only the main page and FAQ are correct.
>
> The port of the xdocs files shouldn't be a problem. This can be done
> in a few days. I only have problems with the Forrest configuration.
> Does someone has experience in using Forrest?
>
> regards,
> Armin
>
>
> Mahler Thomas wrote:
>> +1 to try out forest!
>>> -----Original Message-----
>>> From: Armin Waibel [mailto:arminw@apache.org]
>>> Sent: Tuesday, March 30, 2004 8:15 PM
>>> To: OJB Developers List
>>> Subject: [proposal] Using Forrest to generate docu
>>>
>>> Hi all,
>>>
>>> I would propose to change the tool for web-site/documentation
>>> generation. Currently Thomas use Maven to the job, but Maven is hard
>>> to handle and has less documentation. Further on Maven corrupt (or
>>> we do something wrong) some of the html-sites, e.g. see
>>> http://db.apache.org/ojb/query.html#report%20queries
>>>
>>> Yesterday I had a first look on Forrest (latest from SVN). It's
>>> really impressing, many things will be handled automatic. Forrest
>>> generates an side-summary (index) at the beginning of each page
>>> (currently we do this by hand), an pdf-file for each site (I think
>>> one big pdf for the whole web-site was currently not supported),
>>> checks for broken links, ...
>>>
>>> I don't have experience in other documentation frameworks, so I
>>> can't do comparisons, anyway it looks fine.
>>>
>>> What do you think?
>>>
>>> regads,
>>> Armin
>>>
>>> ---------------------------------------------------------------------
>>> To unsubscribe, e-mail: ojb-dev-unsubscribe@db.apache.org
>>> For additional commands, e-mail: ojb-dev-help@db.apache.org
>>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: ojb-dev-unsubscribe@db.apache.org
>> For additional commands, e-mail: ojb-dev-help@db.apache.org
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: ojb-dev-unsubscribe@db.apache.org
> For additional commands, e-mail: ojb-dev-help@db.apache.org
>
>
---------------------------------------------------------------------
To unsubscribe, e-mail: ojb-dev-unsubscribe@db.apache.org
For additional commands, e-mail: ojb-dev-help@db.apache.org
Re: [proposal] Using Forrest to generate docu
Posted by Thomas Mahler <th...@web.de>.
Hi again,
Armin Waibel wrote:
>
>
> Thomas Mahler wrote:
>
>> Wow, I'm impressed! The forrest style pages look really nice!
>>
>
> Indeaed! But new Maven style looks great too, so this isn't an argument
> for using Forrest ;-)
> A great feature of Forrest is the automatic generation of a TOC/Index on
> top of each page (and pdf generation). I think Maven doesn't support this.
> I'm not sure but when using Forrest we will loose the "Project
> Info"/"Project Reports" pages automatic generated (if configuration is
> correct ;-)) by Maven. I can't find similar in Forrest.
Mhh, I never managed to get the project reports working for us... So it
won't be a real loss...
Thomas
>
> regards,
> Armin
>
>> Thomas
>>
>>
>> Armin Waibel wrote:
>>
>>> Hi all,
>>>
>>> I played a little bit with Forrest and generate an "early alpha"
>>> version of the OJB webpage. Have a look at this:
>>>
>>> http://www.powaibel.de/ojb/index.html
>>>
>>> Most pages are corrupted (+pdf-files missing), because the xml-files
>>> are not ported to Forrest. Only the main page and FAQ are correct.
>>>
>>> The port of the xdocs files shouldn't be a problem. This can be done
>>> in a few days. I only have problems with the Forrest configuration.
>>> Does someone has experience in using Forrest?
>>>
>>> regards,
>>> Armin
>>>
>>>
>>> Mahler Thomas wrote:
>>>
>>>> +1 to try out forest!
>>>>
>>>>
>>>>> -----Original Message-----
>>>>> From: Armin Waibel [mailto:arminw@apache.org]
>>>>> Sent: Tuesday, March 30, 2004 8:15 PM
>>>>> To: OJB Developers List
>>>>> Subject: [proposal] Using Forrest to generate docu
>>>>>
>>>>> Hi all,
>>>>>
>>>>> I would propose to change the tool for web-site/documentation
>>>>> generation. Currently Thomas use Maven to the job, but Maven is
>>>>> hard to handle and has less documentation. Further on Maven corrupt
>>>>> (or we do something wrong) some of the html-sites, e.g. see
>>>>> http://db.apache.org/ojb/query.html#report%20queries
>>>>>
>>>>> Yesterday I had a first look on Forrest (latest from SVN). It's
>>>>> really impressing, many things will be handled automatic. Forrest
>>>>> generates an side-summary (index) at the beginning of each page
>>>>> (currently we do this by hand), an pdf-file for each site (I think
>>>>> one big pdf for the whole web-site was currently not supported),
>>>>> checks for broken links, ...
>>>>>
>>>>> I don't have experience in other documentation frameworks, so I
>>>>> can't do comparisons, anyway it looks fine.
>>>>>
>>>>> What do you think?
>>>>>
>>>>> regads,
>>>>> Armin
>>>>>
>>>>> ---------------------------------------------------------------------
>>>>> To unsubscribe, e-mail: ojb-dev-unsubscribe@db.apache.org
>>>>> For additional commands, e-mail: ojb-dev-help@db.apache.org
>>>>>
>>>>
>>>>
>>>> ---------------------------------------------------------------------
>>>> To unsubscribe, e-mail: ojb-dev-unsubscribe@db.apache.org
>>>> For additional commands, e-mail: ojb-dev-help@db.apache.org
>>>>
>>>>
>>>>
>>>
>>> ---------------------------------------------------------------------
>>> To unsubscribe, e-mail: ojb-dev-unsubscribe@db.apache.org
>>> For additional commands, e-mail: ojb-dev-help@db.apache.org
>>>
>>>
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: ojb-dev-unsubscribe@db.apache.org
>> For additional commands, e-mail: ojb-dev-help@db.apache.org
>>
>>
>>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: ojb-dev-unsubscribe@db.apache.org
> For additional commands, e-mail: ojb-dev-help@db.apache.org
>
>
---------------------------------------------------------------------
To unsubscribe, e-mail: ojb-dev-unsubscribe@db.apache.org
For additional commands, e-mail: ojb-dev-help@db.apache.org
Re: [proposal] Using Forrest to generate docu
Posted by Armin Waibel <ar...@apache.org>.
Thomas Mahler wrote:
> Wow, I'm impressed! The forrest style pages look really nice!
>
Indeaed! But new Maven style looks great too, so this isn't an argument
for using Forrest ;-)
A great feature of Forrest is the automatic generation of a TOC/Index on
top of each page (and pdf generation). I think Maven doesn't support this.
I'm not sure but when using Forrest we will loose the "Project
Info"/"Project Reports" pages automatic generated (if configuration is
correct ;-)) by Maven. I can't find similar in Forrest.
regards,
Armin
> Thomas
>
>
> Armin Waibel wrote:
>
>> Hi all,
>>
>> I played a little bit with Forrest and generate an "early alpha"
>> version of the OJB webpage. Have a look at this:
>>
>> http://www.powaibel.de/ojb/index.html
>>
>> Most pages are corrupted (+pdf-files missing), because the xml-files
>> are not ported to Forrest. Only the main page and FAQ are correct.
>>
>> The port of the xdocs files shouldn't be a problem. This can be done
>> in a few days. I only have problems with the Forrest configuration.
>> Does someone has experience in using Forrest?
>>
>> regards,
>> Armin
>>
>>
>> Mahler Thomas wrote:
>>
>>> +1 to try out forest!
>>>
>>>
>>>> -----Original Message-----
>>>> From: Armin Waibel [mailto:arminw@apache.org]
>>>> Sent: Tuesday, March 30, 2004 8:15 PM
>>>> To: OJB Developers List
>>>> Subject: [proposal] Using Forrest to generate docu
>>>>
>>>> Hi all,
>>>>
>>>> I would propose to change the tool for web-site/documentation
>>>> generation. Currently Thomas use Maven to the job, but Maven is hard
>>>> to handle and has less documentation. Further on Maven corrupt (or
>>>> we do something wrong) some of the html-sites, e.g. see
>>>> http://db.apache.org/ojb/query.html#report%20queries
>>>>
>>>> Yesterday I had a first look on Forrest (latest from SVN). It's
>>>> really impressing, many things will be handled automatic. Forrest
>>>> generates an side-summary (index) at the beginning of each page
>>>> (currently we do this by hand), an pdf-file for each site (I think
>>>> one big pdf for the whole web-site was currently not supported),
>>>> checks for broken links, ...
>>>>
>>>> I don't have experience in other documentation frameworks, so I
>>>> can't do comparisons, anyway it looks fine.
>>>>
>>>> What do you think?
>>>>
>>>> regads,
>>>> Armin
>>>>
>>>> ---------------------------------------------------------------------
>>>> To unsubscribe, e-mail: ojb-dev-unsubscribe@db.apache.org
>>>> For additional commands, e-mail: ojb-dev-help@db.apache.org
>>>>
>>>
>>>
>>> ---------------------------------------------------------------------
>>> To unsubscribe, e-mail: ojb-dev-unsubscribe@db.apache.org
>>> For additional commands, e-mail: ojb-dev-help@db.apache.org
>>>
>>>
>>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: ojb-dev-unsubscribe@db.apache.org
>> For additional commands, e-mail: ojb-dev-help@db.apache.org
>>
>>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: ojb-dev-unsubscribe@db.apache.org
> For additional commands, e-mail: ojb-dev-help@db.apache.org
>
>
>
---------------------------------------------------------------------
To unsubscribe, e-mail: ojb-dev-unsubscribe@db.apache.org
For additional commands, e-mail: ojb-dev-help@db.apache.org
Re: [proposal] Using Forrest to generate docu
Posted by Thomas Mahler <th...@web.de>.
Wow, I'm impressed! The forrest style pages look really nice!
Thomas
Armin Waibel wrote:
> Hi all,
>
> I played a little bit with Forrest and generate an "early alpha" version
> of the OJB webpage. Have a look at this:
>
> http://www.powaibel.de/ojb/index.html
>
> Most pages are corrupted (+pdf-files missing), because the xml-files are
> not ported to Forrest. Only the main page and FAQ are correct.
>
> The port of the xdocs files shouldn't be a problem. This can be done in
> a few days. I only have problems with the Forrest configuration. Does
> someone has experience in using Forrest?
>
> regards,
> Armin
>
>
> Mahler Thomas wrote:
>
>> +1 to try out forest!
>>
>>
>>> -----Original Message-----
>>> From: Armin Waibel [mailto:arminw@apache.org]
>>> Sent: Tuesday, March 30, 2004 8:15 PM
>>> To: OJB Developers List
>>> Subject: [proposal] Using Forrest to generate docu
>>>
>>> Hi all,
>>>
>>> I would propose to change the tool for web-site/documentation
>>> generation. Currently Thomas use Maven to the job, but Maven is hard
>>> to handle and has less documentation. Further on Maven corrupt (or we
>>> do something wrong) some of the html-sites, e.g. see
>>> http://db.apache.org/ojb/query.html#report%20queries
>>>
>>> Yesterday I had a first look on Forrest (latest from SVN). It's
>>> really impressing, many things will be handled automatic. Forrest
>>> generates an side-summary (index) at the beginning of each page
>>> (currently we do this by hand), an pdf-file for each site (I think
>>> one big pdf for the whole web-site was currently not supported),
>>> checks for broken links, ...
>>>
>>> I don't have experience in other documentation frameworks, so I can't
>>> do comparisons, anyway it looks fine.
>>>
>>> What do you think?
>>>
>>> regads,
>>> Armin
>>>
>>> ---------------------------------------------------------------------
>>> To unsubscribe, e-mail: ojb-dev-unsubscribe@db.apache.org
>>> For additional commands, e-mail: ojb-dev-help@db.apache.org
>>>
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: ojb-dev-unsubscribe@db.apache.org
>> For additional commands, e-mail: ojb-dev-help@db.apache.org
>>
>>
>>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: ojb-dev-unsubscribe@db.apache.org
> For additional commands, e-mail: ojb-dev-help@db.apache.org
>
>
---------------------------------------------------------------------
To unsubscribe, e-mail: ojb-dev-unsubscribe@db.apache.org
For additional commands, e-mail: ojb-dev-help@db.apache.org