Ir para o conteúdo

Projetos

Contexto, pertinência e relevância

Esta documentação contém sugestões oriundas de pesquisas e vivências em contextos sociais específicos.

Elas de modo algum são sugestões universais ou imposições de uma forma de agir e se comportar.

Não são modelos no sentido de que devem ser seguidos, mas modelos no sentido de que podem ser adotados, adaptados ou até mesmo criticados e melhorados, desde que ajudem, sejam úteis a façam sentido.

Documentação incompleta

A documentação a seguir encontra-se num estágio ainda inicial, muito incompleto e pode não fazer sentido fora do conteúdo para o qual ela foi criada.

Trabalho adicional ainda é necessário para que ela esteja num estado minimamente útil e compreensível.

Sistemas de tarefas simples

Sistema de tickets, como por exemplo:

  • No README.
  • Arquivo TODO em formatos plaintext, Markdown, YAML ou híbridos.
  • Um arquivo por tarefa em pastas open e closed.
  • Ditz, bugs-everywhere, taskwarrior ou similar.
  • Aplicação própria (Trac, etc)
  • TODOs and FIXMEs ao longo do código em última instância.

Projetos de Software

  • Vagrantfile e manifests do puppet.
  • Git ou VCS usado upstream.
  • Branches de desenvolvimento e upstream.
  • Workflow padrão (git-flow, git-hooks, etc).
  • Suíte de testes.
  • Adotar Semantic Versioning.

Ferramentas