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.
Thanks
Sharan
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
