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 Você Pode Ajudar

Se você perceber algum erro, algo que esteja incompleto, algo que não tenha sido bem abordado ou apenas alguma coisa que não esteja exatamente de seu agrado, veja como você pode ajudar:

  1. Clique no link editar da seção que você quer modificar.
  2. Acesse o Cookbook usando seu login do Bakery, se solicitado. Qualquer pessoa pode ter uma conta no bakery!
  3. Por favor, releia as orientações para contribuir com o Cookbook para garantir a consistência do manual.
  4. Envie adições/edições para revisão usando HTML válido e semântico.
  5. Acompanhe o progresso de suas submissões usando feeds rss ou retorne no dia seguinte para ver suas alterações foram aprovadas.
  6. Volta no próximo dia para ver se suas alterações foram aprovadas.

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 submeta traduções parciais.
  • 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.