Categoria:!Predefinições para predefinições

Da Thinkfn
Revisão das 05h46min de 15 de novembro de 2008 por Bmwmb (discussão | contribs)

Categoria para predefinições
A categoria !Predefinições para predefinições só deve ser atribuída a predefinições. Não a atribua a artigos.
Pode navegar todas as categorias para predefinições a partir da Categoria:!Predefinições.

Esta categoria reúne predefinições que são usadas somente noutras predefinições. São necessárias, para articular todo o mecanismo de protecção, de documentação, de desenvolvimento e de testes das predefinições já existentes, sem as afectar.

Em geral, o mecanismo permite ter na página de cada predefinição somente o código da predefinição em si. Todos os restantes elementos são colocados noutras páginas adicionais, que têm certos sufixos chave. Os nomes das diferentes páginas são:

  • Predefinição:<nome>
Esta é a página da predefinição, com o código da mesma.
  • Predefinição:<nome>/doc
Esta é a página de documentação da predefinição. Ela é incluída (transcluded) na página de predefinição usando {{documentation}}.
  • Predefinição:<nome>/parameterlist
Esta página deve listar os parâmetros que a predefinição aceita, e as suas combinações mais comuns. Ela deve ser incluída (transcluded) na página de documentação e apresentada ao utilizador quando estes são usados incorrectamente.
  • Predefinição:<nome>/tst [NOTA: PRELIMINAR - NÃO USAR]
Esta página deve conter casos de teste para verificar o comportamento da predefinição em diferentes cenários de utilização, incluindo os casos limite nos quais as predefinições devem, mesmo assim, ter um comportamento elegante.
  • Predefinição:<nome>/dev [NOTA: PRELIMINAR - NÃO USAR]
Esta página é usada para experiências e alterações ao código da predefinição. Os seus resultados podem ser verificados na página de testes antes de migrar o novo código para a predefinição.

Para além de articular o mecanismo de desenvolvimento, a separação dos diferentes elementos permite que somente a página da predefinição (a primeira na lista acima) esteja protegida contra edições.

Os utilizadores podem continuar a alterar as restantes páginas, por exemplo introduzindo melhorias na documentação ou experimentando o resultado de alterações. Para que uma alteração ao código da predefinição seja adoptada, devem pedir a um administrador que o migre para a definição protegida.