Re: [Health] Documentation

[Luis Falcon]

Hi Paras / Ronald !

On Tue, Nov 20, 2012 at 6:20 AM, Paras Jasani <address@hidden> wrote:
> Hi
>
> Along with documentation we can also upload videos. How about opening up a
> You Tube stream ?
That would be great ! Either in Youtube or Vimeo, we'll be happy to
have GNU Health educational videos.

I think that we should think about linking them to the documentation,
so we can relate to them on each section.

Now, this is what I propose:
1) Work on the full documentation for 1.8.x series ( release date end
of December ).
2) Once we have it documented, we start creating the videos for the
main sections.
3) For the videos, I suggest we come to a consensus on the look and
feel for the demos, so they look homogeneous. Also, use the same demo
data (as we have in the demo database ), so we can relate.

What do you think ?

Best,
>
> Thanks
> Paras
>
>
> On Fri, Nov 16, 2012 at 9:36 PM, Luis Falcon <address@hidden>
> wrote:
>>
>> Hi Ronald !
>>
>> On Thu, Nov 15, 2012 at 5:31 AM, ronald munjoma <address@hidden> wrote:
>> > Good day,
>> >
>> > There has been a lot of requests for documentation on GNU Health on and
>> > off
>> > list. The current documentation resides on Wikibooks [0]
>> >
>> > The documentation of GNU Health is community built and community
>> > maintained
>> > (with most of the work been done by GNU Solidario, and that should
>> > change).
>> >
>> > I agree with everyone that the documentation could be improved and more
>> > functionality could be covered. I will be very grateful if community
>> > members
>> > could provide feedback on the current documentation (comments on what
>> > works,
>> > what does not work, what is out of date and what needs to be improved).
>> >
>> > Do we need to create a mailing list for people interested in the
>> > documentation project? Or should we continue to have documentation
>> > related
>> > discussions on the general list (creating some noise for those not
>> > interested in the subject)?
>> >
>> It sounds like a good idea to use another space for the documentation
>> discussion. Both either in health-documentation list or in the same
>> Wikibooks discussion area. Actually both complement each other, so
>> they could co-exist.
>>
>> > Which areas, modules and functionality do you want documented first?
>> > Health
>> > Services (Billing), Insurance??
>> >
>> > Is there documentation that we can borrow or reference to from Tryton
>> > documentation [1]
>> >
>> > Is there need to split the existing documentation [0] into?:
>> > - user manual/guide
>> > - implementer/administrator guide
>> > - developer guide
>> The user manual and technical manual schema already exists at Wikibooks.
>> >
>> > In a chat I had with Luis he advised that the target is that by the next
>> > series 1.8.x ( with Tryton 2.6 support ) all the current functionality
>> > should be documented by then.
>> >
>> > your comments, views and suggestions are welcome in an effort to improve
>> > the
>> > GNU Health documentation.
>> We need to be able to deliver all the documentation with 1.8. So
>> probably the best starting point is to start filling up the current
>> undocumented sections.
>>
>> Best
>> >
>> > [0] http://en.wikibooks.org/wiki/GNU_Health
>> >
>> > [1] http://doc.tryton.org/2.4/
>> >
>> > Regards
>> > Ronald Munjoma
>>
>>
>>
>> --
>> Luis Falcon
>> GNU Health
>> http://health.gnu.org
>>
>



--
Luis Falcon
GNU Health
http://health.gnu.org