Envio de correções rápidas de documentos¶

For small changes to a document, it's actually very easy for anyone to submit changes without going through the whole process of raising a JIRA issue against DHIS 2. This can be done directly in GitHub and requires no knowledge of git. All you need is a GitHub account!.

Esta seção pretende ser um guia passo a passo para fazer alterações simples.

Passo a passo para correção de digitação¶

In this scenario, we are reading the documentation and find a typo (the word manditory should be mand**a**tory):

This is in the chapter on "Using the Capture app" in the DHIS 2 User Manual. We want to fix this, so...

1. Fazemos logon no GitHub: https://github.com/dhis2/dhis2-docs

Se você não tem uma conta, siga o link Sign up no site GitHub (public accounts are free)

1. Now we need to find the chapter that we want to change in GitHub. We simply go to the page we want to change on the DHIS2 documentation site and scroll to the top of the page. On the right side, above the main content, is an edit (pencil) icon. For pages with multiple versions, we select the one we want before editing; here we have selected the master version.

   

2. Clicking the edit icon on the docs site takes us directly to the relevant file in GitHub.

   

3. From here we can choose to edit the file (pencil icon). An edit panel is displayed:

   Here we have found and highlighted the offending word!

   

   Don't worry about the blue warning at the top that says we don't have write access to the file!

   We can make the change and preview it in the Preview changes tab if we want.
   Here is the preview:

   

4. Finally we can submit our change as a Pull Request (PR). We add a title for the change (and an optional description) and click Propose file change

   

   a. We see a summary of our changes and click Create pull request:

   

5. Tudo feito!

A pull request is now in the system, which can be easily reviewed and accepted by the DHIS 2 team.

Uma vez aceita, a mudança aparecerá na próxima compilação da documentação!