Status Geral do Projeto

[ericdouglas]

Nessa issue vamos listar todos os capítulos do projeto e listar seus respectivos status, que são:

• não traduzido
• parcialmente traduzido
• traduzido
• online (capítulo no site)

Capítulos

Capítulo	Status	Log
Introdução	traduzido online	⎙
1. Valores, Tipos e Operadores	traduzido online	⎙
2. Estrutura do Programa	traduzido online	⎙
3. Funções	traduzido online	⎙
4. Estrutura de Dados: Objeto e Array	traduzido online	⎙
5. Funções de Ordem Superior	traduzido online	⎙
6. A Vida Secreta dos Objetos	traduzido online	⎙
7. Prática: Vida Eletrônica	traduzido online	⎙
8. Erros e Manipulação de Erros	traduzido online	⎙
9. Expressões Regulares	traduzido online	⎙
10. Módulos	traduzido online	⎙
11. Prática: A Linguagem de Programação	traduzido online	⎙
12. JavaScript e o Navegador	traduzido online	⎙
13. O Document Object Model	traduzido online	⎙
14. Manipulando Eventos	traduzido online	⎙
15. Projeto: Plataforma de Jogo	traduzido online	⎙
16. Desenhando no Canvas	traduzido online	⎙
17. HTTP	traduzido online	⎙
18. Formulários e Campos de Formulários	traduzido online	⎙
19. Projeto: Um Programa de Pintura	traduzido online	⎙
20. Node.js - (Parte 3: Node.js)	traduzido online	⎙
21. Projeto: Website de Compartilhamento de Habilidades	traduzido online	⎙

[ericdouglas]

Pessoal, estou com dificuldade em ver qual o status de cada capítulo.

Alguns estão com a issue fechada, mas acho que não passaram pela revisão/supervisão completa.

Como sugerem fazer essa verificação?

cc/ @joaostein @SauloSilva @gabrielfgularte @rands0n

[joaostein]

acredito em melhoria contínua. acredito que esse status deveria representar traduzido ou não traduzido/incompleto. penso que a revisão é algo contínuo que será feito através de PRs dos próprios leitores (e pessoas que, por vontade própria, se candidatam a ajudar com as melhorias), principalmente porque sempre vamos ter como melhorar (seja gramática, imprecisão de tradução, consistência, etc…).

Essa issue pode ser o ponto de referência com essa tabela que contém todas as informações necessárias de cada capítulo, sendo elas: status, log, link p/ site. (mais ideias aqui são bem-vindas 😄)

Depois, podemos limpar (fechar) todas as issues abertas (exceto essa) para fácil acesso/visualização das informações relevantes que estarão contidas aqui.

A medida que novos PRs de melhoria forem sendo feitos, vamos adicionando ref #issue-de-log-do-capitulo sempre que dermos merge (caso não tenha sido feito pelo próprio autor do PR) para termos tudo referenciado.

Dessa forma eliminamos essa noção de “etapas” e passamos a pensar em um processo contínuo de melhoria, eliminando qualquer tipo de burocracia para novas pessoas participarem do projeto e, além disso, ser bem flexível quando fizermos novas contribuições.

O que acham? algum feedback, ideias e argumentações? o mais importante é que todos fiquem felizes e satisfeitos com o direcionamento :)

[ericdouglas]

@joaostein dessa forma fica excelente, pois agora precisamos apenas fechar a tradução e passar para o site e pronto, finalizamos!

Se todos tiverem de acordo, só precisamos atualizar a tabela com as labels:

• não traduzido
• parcialmente traduzido
• traduzido
• online

[ericdouglas]

Listei o status de todos os capítulos!

Vou ir terminando as tarefas do início para o final, então os capítulos não traduzidos irei traduzir e depois deixar online.

Minha próxima tarefa vai ser deixar o cap. 6 online.

😄

[gabrielfgularte]

Boooa! Ótima iniciativa!

A propósito... voltei de viagem, mas to enrolado com uns projetos zumbi aqui... hahahaha. Em breve retomo as contribuições. (em breve espero que seja amanhã ou depois, no máximo.)

[ericdouglas]

Show @gabrielfgularte ! 👍

[SauloSilva]

Pessoal acho que deveríamos manter as labels, eu não entendi o motivo da remoção. Sem elas ficou tudo muito confuso e nosso CONTRIBUTING.md ficou inconsistente.
E após o capítulo ser supervisionado e inserido no site (capítulo finalizado), acho que a issue deveria ser fechada.

cc/ @ericdouglas @joaostein @gabrielfgularte @rands0n

[ericdouglas]

@SauloSilva achei que a sugestão do @joaostein válida pois dessa forma a responsabilidade de consertar os "bugs" será de todos, principalmente de quem estiver lendo.

Mas nada impede só a falta de tempo de revisarmos os capítulos da mesma forma feita anteriormente.

[SauloSilva]

@ericdouglas a idéia do @joaostein não impede de termos label nas issues que ainda falta (tradução, revisão, supervisão), acho que as labels nos da a noção do que falta no capítulo (como tu disse ali em cima "estou com dificuldade em ver qual o status de cada capítulo"). O fechamento das issues depois do término do ciclo também é válido, por exemplo existem alguns capítulos que já foram supervisionados e que poderia ter suas issues fechadas.

Acho também que todos os capítulos traduzidos sem revisão ou supervisão deveriam estar publicados no site, mas suas issues deveriam ser mantidas abertas e com o estado atual (labels), assim o leitor que achar algo errado no site poderá entrar no repositório e ver que o capítulo ainda não esta finalizado, sendo assim haverá a possibilidade de contribuição para o processo.

Acho que a gente tinha um sistema legal nas issues antes, só estava faltando o conteúdo ser publicado.

E para ajudar o processo contínuo acho que um CI resolveria o problema, pois atualmente temos dois trabalho, do merge e da publicação no site que ainda é manual.

Resumindo, sou a favor de voltarmos com as labels, fechar as issues finalizadas (supervisionadas), publicar tudo que temos traduzido que esta na master e pensarmos em uma estrutura para o site suportar integrações/deploys automáticos quando houver atualizações de conteúdo.

[ericdouglas]

@SauloSilva fazendo estes passos que você citou (e que estávamos fazendo) é a forma mais profissional de se fazer.

Hoje, o que estou focado é entregar o nosso MVP, que consiste na tradução de todos os capítulos e na publicação dos mesmos.

Creio que podemos focar no MVP agora e depois decidimos os próximos passos.

ps: falta bem pouco para entregarmos o MVP 😄

[rands0n]

Boa @ericdouglas, também gostei da ideia do mvp.

[joaostein]

Respondendo @SauloSilva :

Pessoal acho que deveríamos manter as labels, eu não entendi o motivo da remoção. Sem elas ficou tudo muito confuso e nosso CONTRIBUTING.md ficou inconsistente

A primeira coisa que precisamos entender é se após fizermos as etapas de “revisão” e “supervisão” ainda teremos espaços para melhorias (seja ela gramática, tradução, typos, atualização de conteúdo, etc…)? Se isso for um fato verdadeiro, as labels de “revisão” e “supervisão” acabam perdendo o sentido, pois elas não são finitas. Elas não são uma etapa que tem um início e fim, sendo um processo contínuo que conta com a colaboração de todos (nós e os próprios leitores).

Sobre o CONTRIBUTING.md, assim que chegarmos em um consenso, podemos atualizá-lo para que fique consistente.

E após o capítulo ser supervisionado e inserido no site (capítulo finalizado), acho que a issue deveria ser fechada.

Com certeza. Concordo no fechamento das issues para facilitar a manutenção do projeto. Quanto menos issues abertas melhor, pois fica mais fácil para novas pessoas contribuírem sem ficarem “perdidas” com a quantidade de informação. Por isso, a ideia de manter apenas uma issue central com todos os dados do capítulo (link p/ log, status e link p/ site) pode ser uma saída interessante para resolver esse problema.

acho que as labels nos da a noção do que falta no capítulo (como tu disse ali em cima “estou com dificuldade em ver qual o status de cada capítulo)

Assumindo o fato de que sempre haverá condições para melhorias nos capítulos, nunca vamos saber de fato quando um capítulo está finalizado, pois ele estará em constante evolução. Acredito que a ideia principal é que lancemos a tradução inicial (podemos usar labels nesse caso, pois a tradução inicial é finita) de cada capítulo, e em seguida, mantemos a manutenção contínua que envolve melhorias.

Acho também que todos os capítulos traduzidos sem revisão ou supervisão deveriam estar publicados no site […]

Absolutamente.

[…] mas suas issues deveriam ser mantidas abertas e com o estado atual (labels), assim o leitor que achar algo errado no site poderá entrar no repositório e ver que o capítulo ainda não esta finalizado, sendo assim haverá a possibilidade de contribuição para o processo

A contribuição de melhoria pode ser feita tanto antes quanto após o capítulo estar “finalizado” (leia traduzido), por isso, não faz muita diferença manter labels e issues específicas abertas após a tradução inicial estar completa.

---

Respondendo @ericdouglas:

Hoje, o que estou focado é entregar o nosso MVP, que consiste na tradução de todos os capítulos e na publicação dos mesmos.

Com certeza. Além disso, organizar as issues e deixar tudo preparado para aceitarmos PRs de melhorias. Esses PRs podem vir de nós mesmos ou outras pessoas que estejam lendo ou queiram ajudar. Eliminamos a ideia de “donos” de capítulos/etapas de revisão+supervisão e deixamos o processo bem suave de melhoria contínua.

[ericdouglas]

"Eliminamos a ideia de “donos” de capítulos/etapas de revisão+supervisão e deixamos o processo bem suave de melhoria contínua."

Estou mais inclinado para essa abordagem, pois assim nos libera para trabalharmos em outros projetos, e eventualmente ajudar em melhorias neste.

[rands0n]

Hoje, o que estou focado é entregar o nosso MVP, que consiste na tradução de todos os capítulos e na publicação dos mesmos.

O @ericdouglas está fazendo PR de uma série de capitulos para adicionar no site. Eu estava pensando em apenas adicionar os que já estiverem ok. Mas essa abordagem do MVP está sendo ótima.

Assim que puder ajudar para adiciona-los ao site farei 😄