ofbiz-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Sharan Foga <sharan.f...@gmail.com>
Subject Re: [PROPOSAL] Restructure OFBiz Wiki
Date Tue, 30 May 2017 06:32:07 GMT
Hi Michael

I've taken a look at the your mind map structure in the Jira and I think 
it's good. So +1 from me to go ahead with the proposal.


On 29/05/17 10:20, Michael Brohl wrote:
> Thank you Sharan for your feedback!
> I forgot to mention that I have attached the mind map to the Jira [1].
> Thanks,
> Michael Brohl
> ecomify GmbH
> www.ecomify.de
> Am 29.05.17 um 09:11 schrieb Sharan Foga:
>> Hi Michael
>> I think the re-structuring our wiki is a task that is long overdue 
>> :-). We know that it is a very big task but in order to improve and 
>> provide organised content for the community, we just need to start. I 
>> agree with your points that the wiki would be better organised 
>> similar to our old OFBiz wiki or the Camel project. My view is that 
>> you present your general restructuring proposal / mindmap so that we 
>> can discuss and agree what the main high level structure will look 
>> like. After that I don't think discussing every move will work, I 
>> think we should just do the work to get it done.
>> I like your attic idea as I'm sure there will be things that are 
>> either outdated or generally won't fit anywhere.
>> Also this could be a great initiative to get contributors involved 
>> that are non coders too!
>> Thanks
>> Sharan
>> On 28/05/17 21:52, Michael Brohl wrote:
>>> Dear all,
>>> according to OFBIZ-9171 [1] I am trying to get some ground to 
>>> restructure our wiki pages. Digging deeper, it becomes more clear to 
>>> me that we have a lot of todos to get this clean and user friendly. 
>>> I am not surprised that users have serious problems to dig through 
>>> all this stuff which is cluttered all over the different spaces.
>>> There is some good documentation buried there and I think it is well 
>>> worth to work on it.
>>> The changes will be huge, I think, and I'm not sure how to start.
>>> I tried to work out some basic ideas and put them in a mind map. 
>>> It's only the tip of the iceberg but it could be a start.
>>> I think it's too much work to do this for alle pages we have so I'd 
>>> like to ask you about your opinions about the following proposed 
>>> next steps:
>>> 1. make the basic structure based on the mind map proposal (after 
>>> review, discussion and related changes).
>>> 2. move everything to Attic/ Outdated Resources which is outdated or 
>>> has no substantial content. This can be reviewed and revived later.
>>> 3. move all subpages to the corresponding main areas
>>> 4. think about the use of different spaces. I think they are 
>>> overhead and everything should be moved under [2].
>>>    See also Jacopo's proposal on [3], which went a bit off-track 
>>> with no decision on the base topic.
>>> 5. review and rewrite the contents to match the new structure 
>>> (divide, join, delete,...)
>>> The main question I have is: do we have to discuss every move or 
>>> even do proposals beforehand or can we just decide on the main 
>>> structure and move on from there? This would make the process much 
>>> more efficient.
>>> What do you think?
>>> Best regards,
>>> Michael Brohl
>>> ecomify GmbH
>>> www.ecomify.de
>>> [1] https://issues.apache.org/jira/browse/OFBIZ-9171
>>> [2] https://cwiki.apache.org/confluence/display/OFBIZ/Home
>>> [3] 
>>> https://lists.apache.org/thread.html/213b00513d1b223863bc7d37d4497e125e38b51115905dfa258e4e64@%3Cdev.ofbiz.apache.org%3E

View raw message