Dear Gerald, On Tue, 12 Dec 2023 14:22:06 +0100 Gerald Wiese <wi...@gnuhealth.org> wrote:
> Hey there, > > I have some points to discuss regarding the documentation: > Great :) > > Modules in Detail chapter: > > I think every module should appear here and have the same name as in > the GUI (health, health_socioeconomics, etc.). A student started > working on this. If you disagree with the approach, tell us soon > please. He will create all subsections and work on some modules but > obviously there will remain open todos. > > https://docs.gnuhealth.org/hmis/modulesindetail/index.html Probably the best approach is to have a generic term and in parentheses the module name: For instance: Socioeconomics (health_socioeconomics) Gynecology and Obstetrics (health_gyneco) I like the concept of sub-sections, specially for modules such as pediatrics (pediatrics_growth_charts, pediatrics_growth_charts_who..) > > > GNU Health HMIS functionality chapter: > > For me those keywords are still not explained precisely enough. I > think longer explanations and a graphic would be nice, maybe even > including Thalamus & MyGNUHealth for an overview. This could also > show if Patient Management, Community Management & Laboratory > Management are subsets of HMIS. And if I understand HIS right, > (multiple) HMIS & Thalamus would be part of it? > > This structure should also match the following documentation. > Currently there is a chapter for Patient Management outside Health > Center Management, a chapter for Laboratory Management inside Health > Center Management and no chapter called Community Management. > It's a bit hard to decide which method would be best, whether we use a package-approach method, where the "Modules in detail" will take more relevance, or a general functionality approach, in which we define the main blocks (Community / demographics, patient, institution management and reporting) and specific references are made to each package/module for the particular documentation section. Personally, I like more the latter, but is not easy, and probably a mix will be the best... what we have to avoid is duplication of concepts / documentation. > Besides abbreviations EMR & HMIS are never written out. > > https://docs.gnuhealth.org/hmis/functionality.html > > > GNU Health Federation > > This chapter can be removed no? > > https://docs.gnuhealth.org/hmis/techguide/techguide.html#techguide-techguide-federation-technical-guide > > It’s here now as separate Thalamus section: > > https://docs.gnuhealth.org/thalamus/ > > Then the link here would have to be updated as well: > > https://docs.gnuhealth.org/hmis/gnuhealthfederation/thalamus.html > > I can do that if you agree. I agree. We should just have a couple of paragraphs explaining the main concepts behind Thalamus and then a link to the component > > Let me know what you think :) I think your ideas are very good :) All the best Luis
