From 9b17392284b14daff13b09c2ec0b10b650aee072 Mon Sep 17 00:00:00 2001
From: Lucas Cavalcanti Rodrigues <lucas.ecomg@gmail.com>
Date: Wed, 23 Mar 2022 15:24:23 -0300
Subject: [PATCH] =?UTF-8?q?[docs]=20Update=20do=20tutorial=20para=20contri?=
 =?UTF-8?q?bui=C3=A7=C3=A3o=20no=20pacote=20python=20(#1151)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* Update README.md

Deixei explícito que as instruções se aplicam para Linux e Mac e adicionei passos para deixar mais claro em que pastas as ações ocorrem.

* update versionamento description

Co-authored-by: Diego Oliveira <d116626@gmail.com>
---
 python-package/README.md | 62 +++++++++++++++++++++++++++++++++-------
 1 file changed, 52 insertions(+), 10 deletions(-)

diff --git a/python-package/README.md b/python-package/README.md
index 3821ddd17..17ca18ebb 100644
--- a/python-package/README.md
+++ b/python-package/README.md
@@ -2,15 +2,23 @@
 
 ## Desenvolvimento
 
-#### Suba o ambiente localmente
+### Linux e Mac:
+
+Clone o repositório principal:
+
+```sh
+git clone https://github.com/basedosdados/mais.git
+```
+Entre na pasta local do repositório usando `cd mais/` e suba o ambiente localmente:
 
 ```sh
 make create-env
 . .mais/bin/activate
+cd python-package/
 python setup.py develop
 ```
 
-### Desenvolva uma nova feature
+#### Desenvolva uma nova feature
 
 1. Abra uma branch com o nome issue-<X>
 2. Faça as modificações necessárias
@@ -19,7 +27,7 @@ python setup.py develop
 4. O nome do PR deve seguir o padrão
   `[infra] <titulo explicativo>`
 
-### O que uma modificação precisa ter
+#### O que uma modificação precisa ter
   
 - Resolver o problema
 - Lista de modificações efetuadas
@@ -31,16 +39,50 @@ python setup.py develop
   
 #### Versionamento
 
-Publique nova versão
+Para publicar uma nova versão do pacote é preciso seguir os seguintes passos:
 
-```sh
-poetry version [patch|minor|major]
-poetry publish --build
+1. Fazer o pull da branch:
+
+```bash
+git pull origin [python-version]
+```
+
+Onde `[python-version]` é a branch da nova versão do pacote.
+
+2. Editar `pyproject.toml`:
+
+O arquivo `pyproject.toml` contém, entre outras informações, a versão do pacote em python da **BD**. Segue excerto do arquivo:
+
+```toml
+description = "Organizar e facilitar o acesso a dados brasileiros através de tabelas públicas no BigQuery."
+homepage = "https://github.com/base-dos-dados/bases"
+license = "MIT"
+name = "basedosdados"
+packages = [
+  {include = "basedosdados"},
+]
+readme = "README.md"
+repository = "https://github.com/base-dos-dados/bases"
+version = "1.6.1-beta.2"
 ```
 
-Versão Alpha e Beta
+O campo `version` deve ser alterado para o número da versão sendo lançada.
 
+3. Push para branch:
+
+```bash
+git push origin [python-version]
 ```
-version = "1.6.2-alpha.3"
-version = "1.6.2-beta.3"
+
+4. Publicação do pacote no PyPI (exige usuário e senha):
+
+Para publicar o pacote no PyPI, use:
+
+```bash
+poetry version [python-version]
+poetry publish --build
 ```
+
+5. Faz merge da branch para a master
+6. Faz release usando a UI do GitHub
+7. Atualizar versão do pacote usada internamente