ofbiz-user mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Ian McNulty <...@mcnultymedia.co.uk>
Subject Re: Migration of Manager Ref PDFs to Wiki Format
Date Wed, 07 Mar 2007 13:17:53 GMT
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.



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/~ian@mcnultymedia.co.uk/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

View raw message