aboutsummaryrefslogtreecommitdiff
path: root/index.mdwn
blob: 96af818593c4087d7ba08f3a5b27c24e4c0a394b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
[[!meta title="Templates"]]

Diversos templates para grupos, projetos e softwares.

Template de Grupo
-----------------

O que um grupo precisa em geral para funcionar:

* Lista de discussão.
* Site público.
* Wiki / intranet com sistema de tickets.
* Licença de distribuição de conteúdo.
* Email de contato.
* Termos de serviço e política de privacidade.
* [Protocolos](https://protocolos.fluxo.info).

Template de Projeto
-------------------

Requisitos mínimos sugeridos:

* Pasta e/ou repositório com subpastas/repositórios opcionais:
  * keyring: repositório [keyringer](https://keyringer.pw).
  * doc: documentação geral.
  * images: imagens.
  * worklog: relatório de tempo.
  * contabilidade: dados financeiros.
  * spool: pasta para arquivos temporários, em composição, etc.
* Arquivo Changelog ou log de mudanças.
* Arquivo de calendário (remind).
* 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.

Template de Software
--------------------

Requisitos básicos:

* 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](http://semver.org).

Criando ou clonando um novo projeto usando o [sandbox script](https://git.fluxo.info/?p=scripts.git;a=blob;f=sandbox;hb=HEAD):

    sandbox <path> [URL]