Re: [Health] First chapters of GNU Health manual in wikibooks

[ronald munjoma]

Hi Luis,

On 24 November 2011 21:38, Luis Falcon <address@hidden> wrote:

Hi Ronald !

On Thu, Nov 24, 2011 at 4:27 PM, ronald munjoma <address@hidden> wrote:
> Hi Luis,
> On 24 November 2011 06:45, Luis Falcon <address@hidden> wrote:
>>
>> Hi Ronald !
>>
>> Thanks for your mail and suggestions. Please check my comments below
>>
>> On Tue, Nov 22, 2011 at 5:56 PM, ronald munjoma <address@hidden> wrote:
>> > Hi Luis,
>> > I think we might need to split our manuals/documentation into:
>> > 1. Administrators manual
>> > -installing, upgrading and maintaining the system (technical stuff)
>> > 2. Users manual
>> Good idea.
>> I would say that what we're working today (including these three
>> initial chapters) is the User Manual. We talk a bit the installation,
>> but is oriented at the general - non-technical - user, so everyone can
>> install the system
>>
>> > * day to day system users
>> > - physcians/doctors/nurses
>> > - lab managers
>> > - front office/reception
>> > - billing/accountants
>> >
>> >
>> > Find below a possible outline of the documentation (based on current
>> > work on
>> > the wiki with comments/suggestions and previous documentation). Once
>> > agreed
>> > on the structure we could then assign documentation team members
>> > chapters to
>> > work on.
>> > Introduction
>> > Installation
>> > - add installation of additional modules instructions
>> > - most common/known issues
>> >   - no trytond.conf file
>> >   - how to use trytond.conf
>> > Booting Up the Tryton Server
>> > - is there a way to set up the server to start at system start up (using
>> > init or something)?
>> > First Steps
>> > - a short description of all the modules (copy paste and edit from:
>> > http://pypi.python.org/pypi/ or     from the module description in the
>> > system)
>> > The Demo Database
>> > - still work in progress
>> > The Main Screen
>> > The Partner Concept
>> > Patients
>> > Families
>> > Institutions
>> > Doctors
>> > Medicaments
>> > Laboratory
>> > Pathologies
>> > Operational Areas
>> > Insurance
>> > Genetics
>> > Appointments
>> > Misc
>> > Billing
>> > Reports
>>
>> It sounds great. I would basically have
>>
>> - User Manual ( including the three chapters we have already and all
>> the modules that you mentioned, separated by the functionality per
>> module. )
>> - Technical Manual ( administrion, security, backups, high
>> availability, reporting )
>> - Trouble shooting
>> - FAQ
>>
>> What do you think ?
>
> All your suggestions sound good. This is my first time using GNU Health and
> writing a manual, your guidance will be greatly appreciated. Is the previous
> documentation still relevant and can it be used as a base for the new
> documentation. How do we move forward?

I wouldn't use much of the previous documentation. I decided to start
from scratch all the screenshots and docs,. but of course many
concepts apply.

I think that we'll do a nice book. We will colectively learn from each
other while writing it and improving it.

I would say that next step is start documenting the main "core"
module. ("health"). We can call the chapter "The main module" and
start documenting it. I think is good to make an introduction of the
module, and then get in the details. (menus, reports, actions,
wizards... ), as well as their links to the HIS.

I like having related screenshots in the form of "thumbnails", related
to the specific topic.

The main module is __very__ large :-) It has a lot of info and
definitely is currently the largest and most important, so it will
take as sometime to finish it.

We probably should first create the chapters and sections index for
the main module. That will guide us all.

Let us create the chapters and sections index, we then allocate each other chapters and sections to work on. Your guidance on the chapters and section indexes will be greatly appreciated.

Regards and thanks

Ronald

What do you think ?

Best

> Regards and thanks
> Ronald
>>
>> Best
>> > regards
>> > Ronald
>> > On 21 November 2011 13:26, Luis Falcon <address@hidden> wrote:
>> >>
>> >> Thanks Ronald !
>> >>
>> >> On Mon, Nov 21, 2011 at 3:41 AM, ronald munjoma <address@hidden>
>> >> wrote:
>> >> > Hi Luis,
>> >> >
>> >> > On 20 November 2011 23:27, Luis Falcon <address@hidden>
>> >> > wrote:
>> >> >>
>> >> >> Dear team
>> >> >>
>> >> >> I just finished the draft of the first chapters of GNU Health manual
>> >> >> in Wikibooks.
>> >> >>
>> >> >> http://en.wikibooks.org/wiki/GNU_Health
>> >> >>
>> >> >> They give you an introduction and cover the basic aspects of
>> >> >> Installation and navigation. At this point I would like to set up a
>> >> >> "documentation team" that will add and review content.
>> >> >>
>> >> >> Please let me know if you're interested.
>> >> >
>> >> > I am interested, count me in.
>> >> >
>> >> > Regards
>> >> > Ronald
>> >> >
>> >> >> Just reviewing will be great !
>> >> >>
>> >> >> Also, I'll be happy to get sugestions and comments on improving it.
>> >> >>
>> >> >> Best,
>> >> >>
>> >> >> --
>> >> >> Luis Falcon
>> >> >> GNU Health
>> >> >> http://health.gnu.org
>> >> >>
>> >> >
>> >> >
>> >>
>> >>
>> >>
>> >> --
>> >> Luis Falcon
>> >> GNU Health
>> >> http://health.gnu.org
>> >>
>> >
>> >
>>
>>
>>
>> --
>> Luis Falcon
>> GNU Health
>> http://health.gnu.org
>>
>
>



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