Jacques,
All that looks good as it stands. It's another one of those essential
engineering resources that I really wouldn't want to be messing around
with it at all.
Imo what is needed in terms of user rather than developer documentation,
is a completely fresh start form a completely different POV.
It isn't the absence of documentation that's the problem. It's the
presence of it. There's just way too much good stuff on offer. Too many
options. Too many possible ways to go.
For the developer this is heaven. For the noob it's confusing...
frustrating... a real turn off.
Take off your racing drivers hat for a moment and put yourself in the
position of someone who just wants something they can drive to work.
Now look at the Wiki. Is there a Start button, or does it look more like
the diagram of a wiring harness that you will never get your head
around? You and I may be interested in using Eclipse, but I can't think
of one client I have ever met who would want to go there. They're all to
busy building their businesses - which is after all what OFBiz is
supposed to be about.
Take another look at Ubuntu.com. Imo that's the way to go. Nice big
buttons! Absolutely nothing there that I don't need to know. And most
people will only read a fraction of that on the first run through anyway
:-/ For the few who want to customise their own hot-rod, all the
essential wiring is there if you look for it. It's just buried out of
the way behind the dashboard instead of scattered all over the floor.
Putting something together like that would require a zero tolerance
policy to any scrap of information that was not absolutely essential to
the business of showing the average driver how to get the thing into
gear and out onto the road.
I doubt if there would be anything new to write. It's basically all there.
But it would mean hacking quite crudely into stuff that the community
has taken years to create.
Without the community's approval, that's a show that could never get on
the road.
Ian
Jacques Le Roux wrote:
Leon, all,
There is already an open Wiki. Just have to create your login :
http://docs.ofbiz.org/pages/listpages-dirview.action?key=OFBIZ. I
can't see a better tool for that : closed for some parts, open for others...
It's up to you folks...
For instance http://docs.ofbiz.org/display/OFBIZ/Online+Developers+Section
might be a good entry point for
http://www.opensourcestrategies.com/ofbiz/tutorials.php.
BTW, I think that we may advertise for this and put a front page to explain how it
works (for instance that the "The Open For
Business Project Wiki" is wide open)
Jacques
----- Original Message -----
From: "Leon Torres" <[EMAIL PROTECTED]>
To: <[email protected]>
Sent: Thursday, January 18, 2007 9:23 PM
Subject: Re: OFBiz/opentaps as a small business accounting package?
I also believe it would be worthwhile to experiment with an open ofbiz wiki. As
the ofbiz community continues to grow, we will certainly attain the critical
mass necessary to make such a thing work.
For instance, we've authored a bunch of cookbooks in .txt format about specific
tricks and how-to's in OFBIZ:
http://www.opensourcestrategies.com/ofbiz/tutorials.php
Unfortunately contributing to those is hard because it takes an investment in
time to read, verify, and update the documents on our end. If they were in the
form of an open wiki, it would be far easier to expand on them.
- Leon
Florin Jurcovici wrote:
IMO, an open wiki is the right thing to do. Even if I had some
experience which I'd like to share, if the wiki is closed or restricted,
I cannot. Some maintainers should review docs occasionally and correct
or delete them if they are not OK, maybe draw an outline of the
documentation at the beginning then let whoever is willing to fill the
pages. But IMO a closed/restricted wiki is not the way to go.
--Florin Jurcovici
------------------
Why do psychics have to ask you for your name?
--
----------------------------------------------------------------------------------------------
mcnultyMEDIA
60 Birkdale Gardens
Durham
DH1 2UL
t: +44 (0)191 384 4736
e: [EMAIL PROTECTED]
w: www.mcnultymedia.co.uk
==============================================================================================
This communication is for the exclusive use of the intended recipient(s) named
above and is confidential. Any form of distribution, copying, discussion or use
of this communication, its contents, or any information contained herein
without prior consent is strictly prohibited. If you receive this communication
in error, please notify the sender by email or by telephone on +44 (0)191 384
4736
This email has been checked for viruses, however, we cannot accept any
liability sustained as a result of software viruses and would recommend that
you carry out your own virus checks before opening any attachment.
==============================================================================================
