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
openeclosed. - 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.