10. Sobre este livro

Este livro é um experimento na publicação Open Source mantendo um produto de software Open Source, o Plone, direcionado para vários espectadores, de usuários finais a desenvolvedores. Produtos Open Source dirigem-se as necessidades de usuários comuns que são raros. De fato, a falta de documentação boa e compreensiva mantém o Código Livre longe de acesso de muitos. Neste apêndice, explicaremos como vamos construir este livro e como você pode contribuir para manter a evolução do Plone.

Regras do livro

Este não é um livro tradicional. Ao invés de matar árvores ele é um arquivo --- uma crescente coleção de documentação disponível na web, editado e organizado para facilitar o uso. Os objetivos do Livro do Plone são claros, corretos, compreensivos e atualizados. Isto significa que também necessita ser adaptado. Enquanto outras documentações são e devem estar disponíveis, o livro quer ser a principal fonte que o usuário precise.

Mecanismos do livro

Ele é escrito usando texto estrutura e armazenado em cvs no Sourceforge no projeto de documentação do Plone (plone-docs).

Processo de Documentação

Este é o processo para escrever a documentação. Pretende ser um guia.

• As pessoas escrevem a documentação de qualquer forma onde eles escolha. Isto faz com que seja fácil para alguém escrever a documentação diminuindo as fronteiras.
• Eles enviam um email para plone-docs dando a localização da documentação que escreveram. Deve ser um email longo, wiki, arquivo texto.
  • Um editor revisa a documentação e se é apropriada é incluída no livro.
  • Um crédito será dado ao autor. [2]
  • A documentação será editada de acordo com o resto do livro em termos de estilo e conteúdo.
  • O editor adiciona na documentação.
• O editor envia um email para plone-docs e ao autor da documentação deixando-o ciente das mudanças.
• Quando novas publicações ocorrere, se aquela documentação não é mais relevante ou incorreta, o autor original será contatado para uma atualização.

Scope e Usuários

Vamos nos concentrar primeiramente nos usuários finais do Plone neste livro. Há vários possíveis usuários e casos de uso, mas a chave é melhorar a usabilidade imediata do Plone. Pode ser tentador documentar o CMF, mas isto deve ser feito somente quando conincidir com o Plone. É também tentador discutir Plone, CMF, Zope, DTML, ZPT e assim por diante. Este não é objetivo do livro, onde foi possível apontamos outras referências (por exemplo o Zope Book) assim os usuários podem achar as soluções.

Funções dos leitores

Estas são as funções sugeridas que os leitores tem que ter:

Usuário do Site

A pessoa que adiciona conteúdo, escreve documentos e assim por diante. Tem segurança muito limitada.

Gerenciador do Site

A pessoa que gerencia o site, desperdiça tempo com abas, caixas e assim por diante. Faz a revisão do conteúdo e modifica as funções. Deve conhecer css e HTML.

Administrador do Site

A pessoa que instala e olha depois a administração do Plone geralmente combinada com uma das outras funções. Mais concentrado em coisas como integração com Apache, etc. Realmente não muito abordado neste livro.

Desenvolvedor

A pessoa que desenvolve código novo para o site com novos produtos e skins.

Editores

Andy McKay

Email para contato: andy@agmweb.ca

Andy roda ZopeZen e Agmweb Consulting. Resultado de várias noites no computador. Quando não sentava na frente do computador Andy podia ser encontrado caminhando com seu cachorro, concertando a casa, surfando ou seu passatempo preferido, usando seu kaiak.

Copyright e Licensa

Os conteúdos deste livro estão sob a licensa Open Publication License v1.0 sem qualquer opção.

[1] Como outros contribuidores terão crédito.

Anterior: Apêndice A: Fontes