From: "Hans Bakker" <[email protected]>
Hi Jacques....
We did not yet found a good WYSIWYG editor. However the xml editors in
Eclipse provide a reasonable environment in creating the text files.
Also realize that these files are now part of the ofbiz system which is
the domain of the programmer who should know about xml?
Yes, but we have to learn docbooks syntax :/
Also about migrating from Confluence, I'd like to test this
http://ffeathers.wordpress.com/2008/09/17/a-confluence-to-xml-export-engine-in-the-making/
If good it could be a mean to create help also (I know well the Confluence Markup language now, and I guess I"m not alone and anyway
there is also the Rich Text mode)
I think the biggest advantage is that the document text is now much
closer to the programmer and stored within the component and can be
updated at the same time. Then you have more chance that the documents
are better structured and more updated.
Yes, I agree on that. Moreover it can help to stay things focused as long as we provide an "online" (actualy local) help for each
page. That's the point of my last message in user ML
Thanks
Jacques
PS : please Hans could you send messages shared on dev ML than directly to me ?
Regards,
Hans
On Wed, 2009-09-02 at 08:33 +0200, Jacques Le Roux wrote:
Hi Hans,
Before answering : I have sent a message to user ML about docbook, what do you think
about an "easy" editor ?
Jacques
From: "Hans Bakker" <[email protected]>
> Somebody put a comment on the list that there should be a 'base' list
> i.e. a list of all functions in the system.
>
> If we would use the docbook xml format then.....
>
> this new feature list and a 'base' list can be created avoiding
> duplicate text. That means when a new feature is created, it can be
> documented in the base list and a reference to it can be added to the
> 'main New Feature' list. The base text can also consist out of included
> text from the help screens.....
>
> perhaps i get too carried away....?
>
> On Wed, 2009-09-02 at 12:59 +0700, Hans Bakker wrote:
>> Perhaps at the same time convert it to the docbook format and put it in
>> ofbiz? In confuence a link can be put to the actual document similar
>> like: http://demo.ofbiz.org/cmssite/cms/APACHE_OFBIZ_HTML ?
>>
>> regards,
>> Hans
>>
>> On Wed, 2009-09-02 at 10:23 +0530, Ashish Vijaywargiya wrote:
>> > Hello Jacques & Others,
>> >
>> > This issue has been discussed before few days but we didn't reach to some
>> > final conclusion AFAIK.
>> > Lets plan how best we can arrange the content of "Main New Feature" page.
>> >
>> > This page is becoming large day by day so opening this page in edit mode
>> > takes long time.
>> > I remembered that in last discussion Vikas Mayur(as I remembered but I
could
>> > be wrong) has suggested to split this on year basis.
>> >
>> > The content of each year can be put in separate page and the link for the
>> > navigation to those pages can be kept either at the top or bottom of this
>> > page.
>> > Lets finalize this thing in this thread and plan to do the needful ASAP.
>> >
>> > Please let me know your thoughts on this.
>> >
>> > --
>> > Ashish
> --
> Antwebsystems.com: Quality OFBiz services for competitive rates
>
--
Antwebsystems.com: Quality OFBiz services for competitive rates
