David,
Whatever you think best if fine with me. Thanks for letting me know.
Ian
David E. Jones wrote:
Thanks for the details on this Ian. I think based on this what Scott
proposed was a good idea, but it's probably best to move this over to
the end user doc space now and then get it into the normal doc
management process we hope for (ie allow people to casually comment on
it, but have a smaller and hopefully more experienced and dedicated
group actually changing it.
-David
On Mar 7, 2007, at 6:17 AM, Ian McNulty wrote:
Hi Scott,
Your message arrived at last! Many thanks.
Yes it was very laborious work. Getting on for a hundred hours in
total if you include finding the right software for the conversion,
researching the extent of the currently existing fragments in the
Wiki, learning the Wiki markup etc. And not great for the RSI in my
mouse arm either. A dirty job, but somebody had to to it ;)
I really am a bit reluctant to comment any more than I already have
on the current content of the docs. As far as I understand it, they
were written by a professional technical writer (which I certainly am
not) and cost something like $40,000 to produce, so they are of
considerable value as they stand. I treated them as such, and made
every effort not to drop even one single word.
As for developing them further, I'm afraid this is way out of my
league. Two months after installing OFBiz, I still don't feel
confident I know how to work it myself, let alone teach anybody else.
I originally started translating the PDFs into editable format with
the aim of re-jigging them into something that I or any of my clients
might be able to use. But after more than a week's work I eventually
had to admit defeat and decided simply to translate them as they
stood in the hope that others might succeed where I had failed. So
any further development of this material really would need to be done
by anybody else except me.
I appreciate your offer of help in answering any questions I might
have, but there are so many that answering them all would probably
mean having to write an entire User's Manual yourself, which would
kindof defeat the purpose of the exercise!
That said, your thanks are appreciated. I just hope that these docs
can now be developed into something useful and that I have been able
to make some kind of contribution towards the further development of
the OFBiz end-user community.
Best,
Ian
Scott Gray wrote:
Hi Ian
I believe these will eventually end up in the End-User docs section
that you mention below, but I wouldn't recommend moving them there
until any major revisions have been completed.
How do you (and anyone else reading) feel about the current content
of the docs? If you or anyone else has time to contribute to them
further then that should take place on the wiki for now, and once
any efforts to improve them have slowed down, they could then be
moved over to the OFBENDUSER space to protect the work that has been
done.
I'd be happy to try and answer any questions you might have if you
decide to work on this further (and I'm sure others would too).
Personally I think you've done a great job migrating the docs and I
can guess how laborious the task must have been (I gave it a go
myself at one point).
Thanks
Scott
Ian McNulty wrote:
Hi All,
I posted news of this a couple of days ago but put it in the
General questions thread by mistake, so thought I ought to try
again on a new thread.
I've now finished migrating the complete set of Undersun Manager
Reference PDFs to Wiki format.
I couldn't get access to the OFBiz End-User Documentation section
so was advised by Jacopo to put them under my Confluence Home page at:
http://docs.ofbiz.org/display/[EMAIL PROTECTED]/Manager+References
Is this where they should stay, or do they now need be moved into a
public section of the Wiki where they can be amended and refined by
others as the project develops?
Ian
--
----------------------------------------------------------------------------------------------
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.
==============================================================================================