Omnis on line help Manual 603 Information Only Need correcting

[Andy Hilton]

Bruno

Great concept - and would be fab - but is there enough man hour capacity to undertake the project ?

Is it something we could - collectively as a group of developers - get started (by simply taking what’s already there in the pdf’s and saving to html pages) at least as a base point ?

I don’t know maybe everyone picks a chapter to do ???

That way, we could all help Mitford so they can remain focussed on engineering and not admin/housekeeping….

Just a wild idea ??!!

Andy

> On Dec 22, 2014, at 11:03 AM, Bruno Del Sol <bruno.delsol at bydesign.fr> wrote:
> 
> Hi,
> 
> Bob Whiting stated officially at Euromnis that the documentation needs to be enhanced, which is great. Unfortunatly, he was not very clear on how they would achieve this enhancement.
> 
> I think that in our domain of expertise there are 2 documentations that are de facto standards of how docs must be organized, and we're all used to at least one of them :
> 
> . http://www.postgresql.org/docs/
> . http://dev.mysql.com/doc/
> 
> So to sum it up, the main features documentation readers need are :
> 
> 1 - there must be a unique source tree for the whole documentation and it must be entirely online and searchable at once.
> 
> 2 - It should be possible to export or print the entire doc as a collection of html files or as a single pdf.
> 
> 3 - Last but not least : TL's tech support and developpers like Kelly Burgess should be able to enhance the documentation by commenting it online. Comments should be moderated by tech support.
> 
> 4 - some kind of history source (wiki, twitter, rss, mailing list, whatever ...) would allow to review recent changes to docs and new comments, and send daily or weekly digests to suscribers.
> 
> HTH
> Regards
> Bruno
> 
> 
> 
> By Design
> http://www.bydesign.fr
> Bruno Del Sol
> bruno.delsol at bydesign.fr
> tel (33) 01 48 78 47 37
> 46, rue de La Tour d'Auvergne
> 75009 Paris (France)
> 
> Le 18/12/14 13:57, Kelly Burgess a écrit :
>> On the original topic Chris asked "Who cares about Vista." and I wrote to him to say I read that stale documentation as meaning "Vista or newer" because that's when Windows started with those shadow app folders, UAC headaches, etc.  So I *think* the docs are still correct if you substitute Win 7 or Win 8 where it refers to Vista.
>> 
>> On the manuals topic, you know what's nice, is to have a single PDF that contains all the manuals and What's New files and other misc. tech notes, so when you search for something you only need to do it once.
>> 
>>    http://www.kellyb.com/AllinOnePDF.jpg
>> 
>> That's a view of a PDF I built awhile back, and how I found 13 occurrences of mouseover in six different PDFs at once.
>> 
>> Please join me in lobbying Mitford House to make available an all-in-one manual.  They don't want me passing mine around, and I think you would all find it a useful thing to have.
>> 
>> Kelly
>> 
>> 
>> 
>> On 18 Dec 2014, at 11:03, Keith Bartlett wrote:
>>> Manual, manual!!  What is a Manual?
>>> 
>>> 
>>> On 18 Dec 2014, at 01:31, Andy Hilton wrote:
>>>>  Who reads manuals ???!
>>>> 
>> _____________________________________________________________
>> Manage your list subscriptions at http://lists.omnis-dev.com
>> 
> 
> _____________________________________________________________
> Manage your list subscriptions at http://lists.omnis-dev.com