Documentation Desparation

2009-09-28 Thread Koray Atalag
Hi Roger, I'd really like the kind of functionality you describe and it is definitely desirable...I was little concerned about the workload implications to already supersaturated core members. And I must say worried about the wording in subject of the thread - the content and quality of

Documentation Desparation

2009-09-28 Thread Tim Cook
On Mon, 2009-09-28 at 17:37 +1300, Koray Atalag wrote: Hi Roger, I'd really like the kind of functionality you describe and it is definitely desirable... https://launchpad.net/oship/ -- next part -- A non-text attachment was scrubbed... Name: signature.asc Type:

Documentation Desparation

2009-09-28 Thread Seref Arikan
Hi Koray, Autocomplete for a syntax colored ADL editor is one of the features planned for Opereffa Eclipse plugins, FYI. All the best Seref On Mon, Sep 28, 2009 at 5:37 AM, Koray Atalag koray at cs.auckland.ac.nzwrote: Hi Roger, I'd really like the kind of functionality you describe and it

Documentation Desparation

2009-09-27 Thread Hugh Leslie
An HTML attachment was scrubbed... URL: http://lists.openehr.org/mailman/private/openehr-technical_lists.openehr.org/attachments/20090927/e97269b2/attachment.html

Documentation Desparation

2009-09-27 Thread Roger Erens
Hi Koray, If you imagine some sort of workbench or platform that can be used to create openEHR-based applications, wouldn't it be nice if the workbench would offer the creator/developer some sort of help along the way? Not with tooltips saying something like See the reference documentation but

Documentation Desparation

2009-09-26 Thread Koray Atalag
Hi All, I really appreciate the mental exercise to achieve a better documentation; however I must say I am really surprised to watch the recent discussions like this one because I wonder if we, as a community yet to solve many fundamental problems and overcome the many challenges, have enough

Documentation Desparation

2009-09-26 Thread Grahame Grieve
+1 Grahame Sent from my iPhone On Sep 25, 2009, at 6:23 PM, Koray Atalag koray at cs.auckland.ac.nz wrote: Hi All, I really appreciate the mental exercise to achieve a better documentation; however I must say I am really surprised to watch the recent discussions like this one

Documentation Desparation

2009-09-26 Thread Stef Verlinden
+2 Stef Op 26 sep 2009, om 08:13 heeft Grahame Grieve het volgende geschreven: +1 Grahame Sent from my iPhone On Sep 25, 2009, at 6:23 PM, Koray Atalag koray at cs.auckland.ac.nz wrote: Hi All, I really appreciate the mental exercise to achieve a better documentation; however I

Documentation Desparation

2009-09-25 Thread Lisa Thurston
An HTML attachment was scrubbed... URL: http://lists.openehr.org/mailman/private/openehr-technical_lists.openehr.org/attachments/20090925/f47874c4/attachment.html -- next part -- A non-text attachment was scrubbed... Name: not available Type: image/png Size: 4972 bytes

Documentation Desparation

2009-09-25 Thread Eric Browne
T[io]m, I don't think the documentation issue is as clear cut as Tim suggests. Here are my observations:- 1. The existing PDF documentation is excellent - far better than many commercial projects. This is partly due to the use of Framemaker, but mostly due to Tom's commitment, knowledge

Documentation Desparation

2009-09-25 Thread Tim Cook
Hi Eric, On Fri, 2009-09-25 at 11:30 +0930, Eric Browne wrote: T[io]m, I don't think the documentation issue is as clear cut as Tim suggests. Here are my observations:- 1. The existing PDF documentation is excellent - far better than many commercial projects. This is partly due to

Documentation Desparation

2009-09-25 Thread Thomas Beale
An HTML attachment was scrubbed... URL: http://lists.openehr.org/mailman/private/openehr-technical_lists.openehr.org/attachments/20090925/da7e9f35/attachment.html -- next part -- A non-text attachment was scrubbed... Name: OceanC_small.png Type: image/png Size: 4972 bytes

Documentation Desparation

2009-09-25 Thread Tim Cook
On Fri, 2009-09-25 at 06:34 +0100, Thomas Beale wrote: Tim, can you point us to some decent documentation online done using the Latex approach? Two quick ones I can think of are LyX itself: http://wiki.lyx.org/LyX/Documentation and CLIPS: http://clipsrules.sourceforge.net/ They aren't as

Documentation Desparation

2009-09-25 Thread Bert Verhees
Anyone already mentioned DocBook? (I am sorry if I mention it again if someone already did) It is an Oasis-standard. Here a list of others who use it: http://wiki.docbook.org/topic/WhoUsesDocBook People can format the layout as they like in any file-format they like. Eventually a standaard PDF

Documentation Desparation

2009-09-25 Thread Erik Sundvall
Hi! On Thu, Sep 24, 2009 at 21:27, Tim Cook timothywayne.cook at gmail.com wrote: ... our own specifications are locked up in these two formats. ?We cannot manipulate them into any kind of help files in order to integrate them into an application and god forbid we think about machine

Documentation Desparation

2009-09-25 Thread Seref Arikan
Dear all, I'd like to express my concerns about practical outcomes of suggested changes, changes based on potential benefits. I'd appreciate your input about the use cases we are discussing just to make sure that I get this right. First of all, translation of openEHR documentation to other

Documentation Desparation

2009-09-25 Thread Tim Cook
Hi Seref, Thanks for your concerns and well thought out points. If you read my original posting, I didn't ask Tom to stop using Framemaker. I ask for some output in place of (or in addition to) the PDF and Framemaker formats. I'll happily accept .doc files at this point. It seems that we have

Documentation Desparation

2009-09-25 Thread Thomas Beale
An HTML attachment was scrubbed... URL: http://lists.openehr.org/mailman/private/openehr-technical_lists.openehr.org/attachments/20090925/1f179327/attachment.html -- next part -- A non-text attachment was scrubbed... Name: OceanC_small.png Type: image/png Size: 4972 bytes

Documentation Desparation

2009-09-25 Thread Thomas Beale
An HTML attachment was scrubbed... URL: http://lists.openehr.org/mailman/private/openehr-technical_lists.openehr.org/attachments/20090925/89db0704/attachment.html -- next part -- A non-text attachment was scrubbed... Name: OceanC_small.png Type: image/png Size: 4972 bytes

Documentation Desparation

2009-09-25 Thread Seref Arikan
Tom, I'd be happy to help you out, just let me know what you need me to do. I'll be putting all of the documentation into Eclipse plugins of Opereffa anyway. We can turn that task into an experiment to lay out some sort of method for transformation of documentation to other formats. Cheers On

Documentation Desparation

2009-09-24 Thread Tim Cook
Hi All, Over the past several years I have discussed this issue with Tom Beale; on mailing lists, off mailing lists and in person. The issue is that Framemaker is a proprietary and basically non standard document format. I fully understand that Tom enjoys the desktop publishing capabilities

Documentation Desparation

2009-09-24 Thread Thomas Beale
An HTML attachment was scrubbed... URL: http://lists.openehr.org/mailman/private/openehr-technical_lists.openehr.org/attachments/20090924/9b109eb9/attachment.html -- next part -- A non-text attachment was scrubbed... Name: OceanC_small.png Type: image/png Size: 4972 bytes