Manual
Bem vindo a versão beta do Cookbook, a nova documentação de aplicação CakePHP. Esperamos que esta nova aplicação ajude na colaboração na documentação, e ao mesmo tempo mantenha um nível elevado do material publicado.
Um enorme agradecimento ao AD7six, que defende a causa do Cookbook, colocando a disposição intermináveis horas de desenvolvimento, testes e melhorando esta aplicação.
# Como funciona:
- Você visita o site e informa qualquer erro, alguma coisa que esteja incompleta, alguma coisa que não foi explicada ou algo que não foi bem formulado.
- Acessa o Cookbook usando seu login do Bakery.
- Envia adições/edições para revisão usando HTML válido e semântico.
- Volta no próximo dia para ver se suas alterações foram aprovadas.
Por favor, reveja o guia de como contribuir com o CookBook para garantir consistência.
# Traduções
Mande um e-mail para John David Anderson (docs em cakephp ponto org) ou no IRC (#cakephp da freenode como _psychic_) para discutir sobre qualquer ajuda que você possa dar.
Dicas de tradução:
- Navegue e edite no idioma que deseja traduzir, senão você não verá o que já foi traduzido.
- Sinta-se livre para "cair de cabeça" mesmo se o idioma para o qual você deseja traduzir já existir no livro.
- Use a todo list (acima à direita) para saber onde sua atenção pode ser mais necessária.
- Use linguagem informal.
- Traduza o título e o conteúdo ao mesmo tempo.
- Atualize links internos para páginas (a serem) traduzidas.
- Compare com a versão em inglês antes de submeter sua atualização (se você corrigir alguma coisa mas não equiparar com o conteúdo original, sua atualização não será aceita).
- Se você precisar escrever alguma palavra em inglês, use a tag
<em>. Exemplo: "asdf asdf Controller asdf" or "asdf asdf Kontroller (Controller) asfd". - Não edite uma seção com revisão pendente.
- Não use html entities para caracteres acentuados, este livro usa UTF-8;
- Não faça alterações significativas na marcação HTML ou adicione novos comentários. Se você acha que está faltando algo no conteúdo original, envie um pedido de edição previamente;
Nós tentamos sempre melhorar a documentação do CakePHP. Você pode nos ajudar usando o Cookbook e traduzindo na medida do possível.
