GOJS Docs

Bem vindo ao GOJS! Neste repositório mantemos nossos documentos oficiais.

Porquê manter os arquivos aqui, assim?

• A opção de os manter no github é para facilitar a colaboração e manuntenção coletiva. Exemplo: Se o Sr. Foobar quiser propor uma restruturação de um parágrafo do estatuto, ou adicionar uma regra, enfim, o Sr. Foobar faria um Pull Request com as modificações propostas e então inicíarimos uma discussão entre os demais membros da comunidade e por fim o time de fundadores/administradores/moderadores fariam o merge do PR ou não. Fazendo coisas the geek way :)
• O GitHub também dispõe do sistema de 'issues' que é bastante útil como um mini-gerenciador de tarefas e projetos. Onde podemos listar o que precisamos fazer ao mesmo tempo que temos um espaço de discussão para tal tarefa. Por exemplo, no caso deste respositório: "Escrever o arquivo REGRAS.md".
• O sistema de issues, bem como o de Pull Requests nos provê um ótimo histórico de versões!
• Temos a conveniência do git + github para vermos diffs dos documentos e acompanhar as mudanças nos mesmos.

Porquê não o Wiki do GitHub ou qualquer outro wiki?

• Para utilizar o Wiki do GitHub temos apenas duas opções: ou qualquer um edita, ou somente que tem permissões de push direto nesse repositório. O que não é nosso intuito.
• Optando pelos arquivos *.md aqui abrimos a possibilidade de Proposições. "Está aqui a mudança que proponho, que tal?" e o consequente debate em torno da tal proposição.
• Já que somos programadores, é mais fácil editar os arquivos e fazer o nosso git push do que ficar mexendo no Wiki. :)
• O histórico (versionamento) e o diff de um repositório git é melhor que o de qualquer Wiki :)

Ah tá, entendi. Mais alguma coisa?

Sim! O principal! Dessa forma, temos em nossas mãos:

• Uma comunidade mais participativa
• A comunidade é realmente feita por ela mesma e não apenas criada e administrada "top-down"
• Os processos e organização da comunidade são transparentes a todo o público
• A colaboração de outras pessoas, inclusive de fora da comunidade, é possível. Por exemplo, talvez um amigo da comunidade Ruby tenha algo pra nos sugerir baseado na experiência dele em sua comunidade, então ele mesmo podería abrir um Pull Request e beneficiar a nossa comunidade Javascript.

Todos esses processos serão descritos nos demais arquivos.

Lista dos arquivos

• README.md - Este arquivo.
• PEOPLE.md - "'Cause that's what we are". Lista das pessoas que fazem o GOJS acontecer.
• CONTRIBUTING.md - Como contribuir para GOJS de forma geral. Nossos processos; Como propor uma mudança, etc.
• ESTATUTO.md - Nosso estatuto
• REGRAS.md - Regras do nosso fórum / grupo de emails / grupo no facebook...
• ...

Lista de repositórios

• goiasjs/gojs - Este repositório, dedicado aos arquivos gerais da comunidade, sistema de issues para novas ideais, etc.
• goiasjs/gojs.org - Repositório do nosso site
• ...