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
