Open andrablaj opened 4 months ago
Thanks @andrablaj, I would add the ANC and PNC as examples of interop scenarios under examples on the doc site, I would propose to move some of the details in the ReadMe to the doc site. @esthermmoturi what do you think with the current doc site revamp? I have also created this ticket to track the changes we need to make on other partner sites.
Hey @Phil-Mwago and @andrablaj , thank you for actively working on documenting the work that's ongoing. With the revamp, I am working to group concepts rather than having them scattered throughout the docsite. The important thing to understand is what you would like to communicate with the audience in the long run? Do you foresee more work being done around interoperability(more workflows, integration with more systems etc?). Would you like a subsection that takes the reader from an overview of the concept, configuration, examples and troubleshooting?
There will be more changes and updates we will need to add to the current documentation. An overview of where to place what would be best informed by the categories or structure you envision to have. I would prefer to have everything around interoperability under one category, then iterate from there. Subsections sound great, with one on the reference app (LTFU) and another that will talk about OpenMRS mediator work.
@Phil-Mwago @esthermmoturi thank you for your thoughts. Can you share a plan on how the documentation should be organized? What should stay in the repo vs. how pages should be organized and where on the docs site. This will give the team a great starting point to create those pages one by one.
Related: #1555
Currently, the CHT Interoperability documentation is focused on Loss To Follow-up workflow and is split across repos as follows:
CHT Interoperability repo:
Docs site:
As we will soon merge the OpenMRS mediator work, the documentation must be updated with OpenMRS <> CHT additional flows.
This seems like a perfect opportunity to reflect on organizing the documentation. What should we keep in the CHT Interoperability repo vs. the docs site?