Diferenças entre edições de "Categoria:!Predefinições para predefinições"
Linha 9: | Linha 9: | ||
::Esta é a página de documentação da predefinição. Ela é incluída ''(transcluded)'' na página de predefinição usando {{tl|documentation}}. | ::Esta é a página de documentação da predefinição. Ela é incluída ''(transcluded)'' na página de predefinição usando {{tl|documentation}}. | ||
* <code>Predefinição:<nome>/parameterlist</code> | * <code>Predefinição:<nome>/parameterlist</code> | ||
− | ::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 | + | ::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. |
* <code>Predefinição:<nome>/tst</code> [NOTA: PRELIMINAR - NÃO USAR] | * <code>Predefinição:<nome>/tst</code> [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. | ::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. |
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}}
.
- Esta é a página de documentação da predefinição. Ela é incluída (transcluded) na página de predefinição usando
-
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.
Páginas na categoria "!Predefinições para predefinições"
Esta categoria contém as seguintes 8 páginas (de um total de 8).
cont. |
cont. |