Diferenças entre edições de "Categoria:!Predefinições para predefinições"

Revisão das 09h01min de 15 de novembro de 2008

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 os parâmetros são incorrectamente usados.

• 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.