Splitting "Main New Feature" page into multiple pages

[Ashish Vijaywargiya]

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

[Jacques Le Roux]

+1. Good idea !

Jacques

From: "Ashish Vijaywargiya" <[hidden email]>

> 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
>

[hans_bakker]

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

[hans_bakker]

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

[Jacques Le Roux]

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" <[hidden email]>

> 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
>

[Jacques Le Roux]

From: "Hans Bakker" <[hidden email]>
> 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" <[hidden email]>
>> > 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
>

[Jacques Le Roux]

Done,

Scot Wilcoxon began a (justified IMO) work at http://docs.ofbiz.org/display/OFBIZ/Feature+summary
Coud please someone help him ?

TIA

Jacques

From: "Ashish Vijaywargiya" <[hidden email]>

> 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
>