document proposal with big diff!

[Hans Bakker]

I have here a diff file of 17Mb (uncompressed) which I, because of its
size did not yet commit. Let me know if somebody has objections.

What does it do?

This diff will add the ability to OFBiz to process docbook
(www.docbook.org) documents and be able to show these documents from a
single xml source file in html, pdf and other formats.

It will also have the possibility to move existing documents from
Confluence (docs.ofbiz.org) back into the ofbiz system and use the same
text for helpscreens and documents.

I know it is big but could improve the documentation for ofbiz
substantially.

Regards,
Hans

--
http://www.antwebsystems.com :
Quality OFBiz support for competitive rates....

[hans_bakker]

I see there is even a plugin for confluence to export documents in the
docbook format.

On Mon, 2009-08-24 at 16:33 +0700, Hans Bakker wrote:

> I have here a diff file of 17Mb (uncompressed) which I, because of its
> size did not yet commit. Let me know if somebody has objections.
>
> What does it do?
>
> This diff will add the ability to OFBiz to process docbook
> (www.docbook.org) documents and be able to show these documents from a
> single xml source file in html, pdf and other formats.
>
> It will also have the possibility to move existing documents from
> Confluence (docs.ofbiz.org) back into the ofbiz system and use the same
> text for helpscreens and documents.
>
> I know it is big but could improve the documentation for ofbiz
> substantially.
>
> Regards,
> Hans
>

--
Antwebsystems.com: Quality OFBiz services for competitive rates

[Ruth Hoffman-2]

Hi Hans:
For what it is worth, my opinion: This would be fantastic! DocBook is
the way to go.
Thanks
Ruth

Hans Bakker wrote:

> I have here a diff file of 17Mb (uncompressed) which I, because of its
> size did not yet commit. Let me know if somebody has objections.
>
> What does it do?
>
> This diff will add the ability to OFBiz to process docbook
> (www.docbook.org) documents and be able to show these documents from a
> single xml source file in html, pdf and other formats.
>
> It will also have the possibility to move existing documents from
> Confluence (docs.ofbiz.org) back into the ofbiz system and use the same
> text for helpscreens and documents.
>
> I know it is big but could improve the documentation for ofbiz
> substantially.
>
> Regards,
> Hans
>
>  

[chris snow]

A big yes from me too!

By the way, have you seen the eclipse process framework (EPF)?  It is a tool for documenting processes.  It was really designed for software development processes such as Rational Unified Process (and it's opensource version - OpenUP), but people are using it to document business processes too.  It would provide structure to developing and publishing ofbiz help.

The site http://epf.eclipse.org/wikis/openup/ was developed using EPF.  As you can see, there are many different views that would be useful for ofbiz: Roles, Delivery Processes, Tasks, etc.

An example workflow documentation:

http://epf.eclipse.org/wikis/openup/process.openup.base/deliveryprocesses/inception_phase_iteration_1EFD4B4F.html?proc=_SuWj4dOPEdyqlogshP8l4g&path=_SuWj4dOPEdyqlogshP8l4g,_8tQrUVQvEd2i9JHp7xurvw,_kYVSUdOPEdyqlogshP8l4g&nodeId=3e2ab3ee

If I get a chance, I will put some ofbiz examples together.

Cheers,

Chris

hansbak wrote

I see there is even a plugin for confluence to export documents in the
docbook format.

On Mon, 2009-08-24 at 16:33 +0700, Hans Bakker wrote:
> I have here a diff file of 17Mb (uncompressed) which I, because of its
> size did not yet commit. Let me know if somebody has objections.
>
> What does it do?
>
> This diff will add the ability to OFBiz to process docbook
> (www.docbook.org) documents and be able to show these documents from a
> single xml source file in html, pdf and other formats.
>
> It will also have the possibility to move existing documents from
> Confluence (docs.ofbiz.org) back into the ofbiz system and use the same
> text for helpscreens and documents.
>
> I know it is big but could improve the documentation for ofbiz
> substantially.
>
> Regards,
> Hans
>
--
Antwebsystems.com: Quality OFBiz services for competitive rates

[BJ Freeman]

does
http://www.docbook.org/tdg/en/html/dbcpyright.html
allow it to be included in apache

Hans Bakker sent the following on 8/24/2009 2:33 AM:

> I have here a diff file of 17Mb (uncompressed) which I, because of its
> size did not yet commit. Let me know if somebody has objections.
>
> What does it do?
>
> This diff will add the ability to OFBiz to process docbook
> (www.docbook.org) documents and be able to show these documents from a
> single xml source file in html, pdf and other formats.
>
> It will also have the possibility to move existing documents from
> Confluence (docs.ofbiz.org) back into the ofbiz system and use the same
> text for helpscreens and documents.
>
> I know it is big but could improve the documentation for ofbiz
> substantially.
>
> Regards,
> Hans
>

--
BJ Freeman
http://www.businessesnetwork.com/automation
http://bjfreeman.elance.com
http://www.linkedin.com/profile?viewProfile=&key=1237480&locale=en_US&trk=tab_pro
Systems Integrator.

[hans_bakker]

Hi BJ,

i too had some concerns so i wrote to Norman Walsh the original designer
and major player....
his reply on my question if we can include the schemas and stylesheets
in OFBiz:

> None at all. Share and enjoy!

so in the next few days you can expect the big commit......

Regards,
Hans



On Mon, 2009-08-24 at 14:14 -0700, BJ Freeman wrote:

> does
> http://www.docbook.org/tdg/en/html/dbcpyright.html
> allow it to be included in apache
>
> Hans Bakker sent the following on 8/24/2009 2:33 AM:
> > I have here a diff file of 17Mb (uncompressed) which I, because of its
> > size did not yet commit. Let me know if somebody has objections.
> >
> > What does it do?
> >
> > This diff will add the ability to OFBiz to process docbook
> > (www.docbook.org) documents and be able to show these documents from a
> > single xml source file in html, pdf and other formats.
> >
> > It will also have the possibility to move existing documents from
> > Confluence (docs.ofbiz.org) back into the ofbiz system and use the same
> > text for helpscreens and documents.
> >
> > I know it is big but could improve the documentation for ofbiz
> > substantially.
> >
> > Regards,
> > Hans
> >
>

--
Antwebsystems.com: Quality OFBiz services for competitive rates

[BJ Freeman]

LOL guess apache severs will get a kick back from my mail server.
my server limits the size of emails.

Hans Bakker sent the following on 8/25/2009 5:57 AM:

> Hi BJ,
>
> i too had some concerns so i wrote to Norman Walsh the original designer
> and major player....
> his reply on my question if we can include the schemas and stylesheets
> in OFBiz:
>
>> None at all. Share and enjoy!
>
> so in the next few days you can expect the big commit......
>
> Regards,
> Hans
>
>
>
> On Mon, 2009-08-24 at 14:14 -0700, BJ Freeman wrote:
>> does
>> http://www.docbook.org/tdg/en/html/dbcpyright.html
>> allow it to be included in apache
>>
>> Hans Bakker sent the following on 8/24/2009 2:33 AM:
>>> I have here a diff file of 17Mb (uncompressed) which I, because of its
>>> size did not yet commit. Let me know if somebody has objections.
>>>
>>> What does it do?
>>>
>>> This diff will add the ability to OFBiz to process docbook
>>> (www.docbook.org) documents and be able to show these documents from a
>>> single xml source file in html, pdf and other formats.
>>>
>>> It will also have the possibility to move existing documents from
>>> Confluence (docs.ofbiz.org) back into the ofbiz system and use the same
>>> text for helpscreens and documents.
>>>
>>> I know it is big but could improve the documentation for ofbiz
>>> substantially.
>>>
>>> Regards,
>>> Hans
>>>

--
BJ Freeman
http://www.businessesnetwork.com/automation
http://bjfreeman.elance.com
http://www.linkedin.com/profile?viewProfile=&key=1237480&locale=en_US&trk=tab_pro
Systems Integrator.