# Ata - 9ª Reunião das pessoas mantenedoras

*Quinta-feira, 25 de novembro de 2021*

[TOC]

## Presentes
- Giulio Carvalho
- Ariane Alves
- Juliana Trevine
- Pedro Guimarães
- André Formento
- Vanz
- Ítalo Epifânio

### Boas-vindas ao Ítalo
- Novo contribuidor do QD, vindo através do Sprint da Python Brasil
- Apresentou o QD na Universidade dele e envolveu em uma Disciplina de Ciência de Dados (começou há poucas semanas)
- 2 grupos fazendo pesquisa no QD: (i) associar cnpj e pessoa física para mapear doações; (ii) aparecimento do kit covid como tratamento na pandemia

## Pauta: Documentação
- Renné está lendo Docs for Developers e passou a usar o QD de caso de estudo para documentar. Mandou alguns arquivos para vermos
- [Diretrizes da Documentação](https://pad.riseup.net/p/querido-diario-docs-keep)
- [Esquema de conteudo](https://docs.google.com/spreadsheets/d/1t6PSaW4KUP7FxjDeqxFFb_t9SZqA9UBWpLwKc2n3i9c/edit#gid=0)
- [Rascunho da proposta no GitHub](https://github.com/rennerocha/querido-diario-docs)
- Giulio sugeriu como fluxo de desenvolvimento da documentação irmos por projeto
- Vanz comentou do [Docusaurus](https://docusaurus.io/)
- Giulio comenta sobre uma demanda de tradução em espanhol também (uma documentação trilingue)
- Discussão sobre critério de tarefa finalizada (quando uma documentação está pronta para passarmos pra próxima?) já que vamos documentar por projeto. Sugeriu que, caso adotemos a documentação trilingue, só passariamos pro próximo projeto depois da documentação em 3 línguas.
- Vanz aponta que se não tivermos uma pessoa dedicada para isso, não vai rolar. Localizamos que não temos pessoas fluentes em espanhol técnico pra isso também.
- Ariane comentou da limitação em participação / pessoas disponíveis para se dedicar à isso. Inclusive colocando em questão que mesmo fazer bilingue (pt-br / eng) já será um desafio
- Pedro defendeu que acha que temos que focar em ter uma documentação estável primeiro, antes de dar o passo extra da tradução

- Encaminhamento:
- A documentação vai ficar no repositório de comunidade. O material do Renné, portanto, será direcionado para lá.
- Decidido que focaremos em ter pelo menos biligue e quando chegarmos no repositório do frontend, ele sim nos dedicaremos a apresentar de forma trilingue

- Ariane dá um feedback em relação à estrutura da documentação proposta pelo Renne. Aponta que gostou da caracterização de usuários e da cobertura da documentação, mas aponta preocupação que a documentação parece caminhar num rumo muito técnico e isso pode afastar pessoas

- Juliana comenta sobre a existẽncia de documentação para devs e documentação para usuário e propõe que tenhamos ambas. Comenta sobre uma estratégia de documentação chamada C4 e que parece se adequar aos nossos projetos.

- Giulio referencia outro esquema de documentação baseado em [quadrantes](https://documentation.divio.com/). E opina que não precisamos nos limitar à um estilo de documentação, mas que podemos sim conhecer/nos inspirar para ter em mente.

- Dialogando com a estrutura da documentação do Renne, Giulio defende que acha que a estrutura está boa e que acha que inclusive o repositório de raspadores poderia ser a de porta de entrada no projeto (voltado às pessoas mais iniciantes)

- Encaminhamento Conversamos sobre onde ficarão os rascunhos do Renne já que estamos acolhendo no projeto. Concordamos que vai para o GitHub, no repositório de comunidade

## Pauta: RO-DOU
- Nitai apresentou um projeto relâmpago no CODA sobre um [robô que raspa o Diário Oficial da União (DOU)](https://github.com/economiagovbr/Ro-dou). No CODA, ele comenta que o projeto se alinha com o objetivo do Querido Diário.
- Conversamos sobre estudar o código do Ro-dou e, possivelmente, convidar o Nitai para alguma reunião e desenvolver melhor essa questão.

## Pauta: encerramento do ano
- Como a próxima reunião seria ao fim de dezembro, no meio do recesso de festas, foi discutido se iria ser a última reunião ou se faríamos alguma ainda (por volta de meados de dezembro, antes das festas). Encaminhamos que esta foi a última reunião e voltamos em janeiro.

###### tags: `Maintainers`, `November`, `2021`