You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@ofbiz.apache.org by Ron Wheeler <rw...@artifact-software.com> on 2014/11/27 16:04:54 UTC
OFBiz End User Docs Home
Is there anything of value here or should we just delete the space and
remove any references to it.
https://cwiki.apache.org/confluence/display/OFBENDUSER/OFBiz+End+User+Docs+Home
It appears that it has not be touched since 2006 (8 years ago) and it is
of no use at all to new end users in its current form.
It hurts the image of the project to have it linked from the front page
of the documentation as our"User Documentation".
Ron
--
Ron Wheeler
President
Artifact Software Inc
email: rwheeler@artifact-software.com
skype: ronaldmwheeler
phone: 866-970-2435, ext 102
Re: OFBiz End User Docs Home
Posted by Jacques Le Roux <ja...@les7arts.com>.
This certainly needs to be revisited but I'd surely not drop it like that!
Jacques
Le 27/11/2014 16:04, Ron Wheeler a écrit :
> Is there anything of value here or should we just delete the space and remove any references to it.
>
> https://cwiki.apache.org/confluence/display/OFBENDUSER/OFBiz+End+User+Docs+Home
>
> It appears that it has not be touched since 2006 (8 years ago) and it is of no use at all to new end users in its current form.
> It hurts the image of the project to have it linked from the front page of the documentation as our"User Documentation".
>
> Ron
>
Re: OFBiz End User Docs Home
Posted by Jacques Le Roux <ja...@les7arts.com>.
Done (commented out) at revision: 1660404
Jacques
Le 27/11/2014 18:30, Jacques Le Roux a écrit :
> That sounds like a smart 1st move to me. People who tend to use search (I do) would not be dispossessed
>
> Jacques
>
> Le 27/11/2014 16:52, Jacopo Cappellato a écrit :
>> We could start by removing the links to it from the OFBiz website: if (ever) the content will be validated we will re-add them.
>>
>> Jacopo
>>
>> On Nov 27, 2014, at 4:04 PM, Ron Wheeler <rw...@artifact-software.com> wrote:
>>
>>> Is there anything of value here or should we just delete the space and remove any references to it.
>>>
>>> https://cwiki.apache.org/confluence/display/OFBENDUSER/OFBiz+End+User+Docs+Home
>>>
>>> It appears that it has not be touched since 2006 (8 years ago) and it is of no use at all to new end users in its current form.
>>> It hurts the image of the project to have it linked from the front page of the documentation as our"User Documentation".
>>>
>>> Ron
>>>
>>> --
>>> Ron Wheeler
>>> President
>>> Artifact Software Inc
>>> email: rwheeler@artifact-software.com
>>> skype: ronaldmwheeler
>>> phone: 866-970-2435, ext 102
>>>
>>
>>
>
Re: OFBiz End User Docs Home
Posted by Jacques Le Roux <ja...@les7arts.com>.
That sounds like a smart 1st move to me. People who tend to use search (I do) would not be dispossessed
Jacques
Le 27/11/2014 16:52, Jacopo Cappellato a écrit :
> We could start by removing the links to it from the OFBiz website: if (ever) the content will be validated we will re-add them.
>
> Jacopo
>
> On Nov 27, 2014, at 4:04 PM, Ron Wheeler <rw...@artifact-software.com> wrote:
>
>> Is there anything of value here or should we just delete the space and remove any references to it.
>>
>> https://cwiki.apache.org/confluence/display/OFBENDUSER/OFBiz+End+User+Docs+Home
>>
>> It appears that it has not be touched since 2006 (8 years ago) and it is of no use at all to new end users in its current form.
>> It hurts the image of the project to have it linked from the front page of the documentation as our"User Documentation".
>>
>> Ron
>>
>> --
>> Ron Wheeler
>> President
>> Artifact Software Inc
>> email: rwheeler@artifact-software.com
>> skype: ronaldmwheeler
>> phone: 866-970-2435, ext 102
>>
>
>
Re: OFBiz End User Docs Home
Posted by Jacopo Cappellato <ja...@hotwaxmedia.com>.
On Nov 27, 2014, at 8:27 PM, Ron Wheeler <rw...@artifact-software.com> wrote:
> Can we clean up that space by:
> a) removing the stuff that is no good - does anyone feel comfortable in making that determination.
> b) organize the remaining content so that it is easy to navigate
> c) fix the text so that it is clearer about what information can be counted on by the new user (remove speculative ideas and proposed changes)
> d) add pages that have information that is of interest to users - training resources, case studies, system integrators supporting OFBiz, etc. that is presented in a way that non-developers (System Administrators, Accountants, CFOs, CEO, Business Analysts, etc. ) can read to get useful information.
> e) add graphics and explanatory texts that makes the documentation attractive to users.
>
> And then keep it up to date.
The plan makes sense but I would suggest to set the acceptance bar rather high in step #1: we should only keep documentation that has proven to be useful, used and maintained. When we are in doubt we could get an export and save it in a zipped archive somewhere and then remove the pages. If we keep a lot of information that is half baked it will be difficult for people like Sharan and Ron to maintain it and assure a good level of quality.
And I would add another step:
f) move the (survived) pages to the Wiki and then drop this Confluence space; the project really doesn't need all these spaces anymore
Jacopo
>
> Ron
> On 27/11/2014 10:52 AM, Jacopo Cappellato wrote:
>> We could start by removing the links to it from the OFBiz website: if (ever) the content will be validated we will re-add them.
>>
>> Jacopo
>>
>> On Nov 27, 2014, at 4:04 PM, Ron Wheeler <rw...@artifact-software.com> wrote:
>>
>>> Is there anything of value here or should we just delete the space and remove any references to it.
>>>
>>> https://cwiki.apache.org/confluence/display/OFBENDUSER/OFBiz+End+User+Docs+Home
>>>
>>> It appears that it has not be touched since 2006 (8 years ago) and it is of no use at all to new end users in its current form.
>>> It hurts the image of the project to have it linked from the front page of the documentation as our"User Documentation".
>>>
>>> Ron
>>>
>>> --
>>> Ron Wheeler
>>> President
>>> Artifact Software Inc
>>> email: rwheeler@artifact-software.com
>>> skype: ronaldmwheeler
>>> phone: 866-970-2435, ext 102
>>>
>>
>
>
> --
> Ron Wheeler
> President
> Artifact Software Inc
> email: rwheeler@artifact-software.com
> skype: ronaldmwheeler
> phone: 866-970-2435, ext 102
>
Re: OFBiz End User Docs Home
Posted by Ron Wheeler <rw...@artifact-software.com>.
Can we clean up that space by:
a) removing the stuff that is no good - does anyone feel comfortable in
making that determination.
b) organize the remaining content so that it is easy to navigate
c) fix the text so that it is clearer about what information can be
counted on by the new user (remove speculative ideas and proposed changes)
d) add pages that have information that is of interest to users -
training resources, case studies, system integrators supporting OFBiz,
etc. that is presented in a way that non-developers (System
Administrators, Accountants, CFOs, CEO, Business Analysts, etc. ) can
read to get useful information.
e) add graphics and explanatory texts that makes the documentation
attractive to users.
And then keep it up to date.
Ron
On 27/11/2014 10:52 AM, Jacopo Cappellato wrote:
> We could start by removing the links to it from the OFBiz website: if (ever) the content will be validated we will re-add them.
>
> Jacopo
>
> On Nov 27, 2014, at 4:04 PM, Ron Wheeler <rw...@artifact-software.com> wrote:
>
>> Is there anything of value here or should we just delete the space and remove any references to it.
>>
>> https://cwiki.apache.org/confluence/display/OFBENDUSER/OFBiz+End+User+Docs+Home
>>
>> It appears that it has not be touched since 2006 (8 years ago) and it is of no use at all to new end users in its current form.
>> It hurts the image of the project to have it linked from the front page of the documentation as our"User Documentation".
>>
>> Ron
>>
>> --
>> Ron Wheeler
>> President
>> Artifact Software Inc
>> email: rwheeler@artifact-software.com
>> skype: ronaldmwheeler
>> phone: 866-970-2435, ext 102
>>
>
--
Ron Wheeler
President
Artifact Software Inc
email: rwheeler@artifact-software.com
skype: ronaldmwheeler
phone: 866-970-2435, ext 102
Re: OFBiz End User Docs Home
Posted by Jacopo Cappellato <ja...@hotwaxmedia.com>.
We could start by removing the links to it from the OFBiz website: if (ever) the content will be validated we will re-add them.
Jacopo
On Nov 27, 2014, at 4:04 PM, Ron Wheeler <rw...@artifact-software.com> wrote:
> Is there anything of value here or should we just delete the space and remove any references to it.
>
> https://cwiki.apache.org/confluence/display/OFBENDUSER/OFBiz+End+User+Docs+Home
>
> It appears that it has not be touched since 2006 (8 years ago) and it is of no use at all to new end users in its current form.
> It hurts the image of the project to have it linked from the front page of the documentation as our"User Documentation".
>
> Ron
>
> --
> Ron Wheeler
> President
> Artifact Software Inc
> email: rwheeler@artifact-software.com
> skype: ronaldmwheeler
> phone: 866-970-2435, ext 102
>