ofbiz-user mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "David E. Jones" <jone...@hotwaxmedia.com>
Subject Re: Migration of Manager Ref PDFs to Wiki Format
Date Wed, 07 Mar 2007 20:40:18 GMT

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.


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/~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