Difference between revisions of "LSL Portal Guidelines/pt"

Revision as of 15:30, 7 September 2008

LSL Portal

Esta página define e descreve Orientações específicas para edição e publicação no Portal LSL Wiki.

Sobre o Portal LSL

Missão

"Fornecer uma documentação precisa para a linguagem de scripts do Second Life: LSL"^[1]

Objetivo

"Fornecer documentação para auxiliar os programadores de todos os níveis de experiência."^[1]

Guias

LSL Editing Primer - Informação sobre gabaritos e sintaxe.

Style

LSL Category Style - Usado para categorizar grupos de funções LSL e outras Tabelas de Conteúdos.
LSL Function Style - Usado para a especificação completa de todas as funções LSL.
LSL Topic Style - Usado para tópicos de interesse relacionados ao uso do LSL (XML-RPC, quatérnions, etc).
LSL Constants Style - Usado para documentar constantes.

Orientações

Páginas específicas à execução do portal LSL ou páginas de categorias deverão ser prefixadas com 'LSL'.
Todas as outras páginas existentes, documentando LSL, com o prefixo LSL, deverão ter o prefixo retirado, a menos que um outro acordo seja feito.
As perguntas deverão ser postadas nas páginas do tipo "talk/discussion" e assinaladas( usar -- ~~~~ para assinalar comentários).
Antes de postar uma sugestão no wiki, verifique se já foi sugerida em Jira.
Quando um script for publicado, se for um script completo, ele deverá compilar sem erros e ser totalmente funcional ou se alertar, em caso contrário. Partes de programas deverão compilar se forem inseridas corretamente em um script (não deverá haver nenhum erro interno nessas partes do código).
Os scripts publicados deverão ter um estilo consistente ao longo do script. A consistência no uso de espaços é importante.
A maioria dos navegadores web vem com corretores ortográficos ou aceitam sua instalação. Todo o conteúdo deverá ser verificado antes de ser postado.

Footnotes

^ Derived from the open sentences of the LSL Portal.

@@ Line 29: / Line 29: @@
 * As perguntas deverão ser postadas nas páginas do tipo "talk/discussion" e assinaladas( usar <code><nowiki>-- ~~~~</nowiki></code> para assinalar comentários).
 * Antes de postar uma sugestão no wiki, verifique se já foi sugerida em [https://jira.secondlife.com/ Jira].
-*
+* Quando um script for publicado, se for um script completo, ele deverá compilar sem erros e ser totalmente funcional ou se alertar, em caso contrário. Partes de programas deverão compilar se forem inseridas corretamente em um script (não deverá haver nenhum erro interno nessas partes do código).
+* Os scripts publicados deverão ter um estilo consistente ao longo do script. A consistência no uso de espaços é importante.
+* A maioria dos navegadores web vem com corretores ortográficos ou aceitam sua instalação. Todo o conteúdo deverá ser verificado antes de ser postado.
-* Pages specific to the running of the LSL portal or category pages should be prefixed with 'LSL '.
-* All other existing pages documenting LSL with the LSL prefix are to be moved out of the LSL prefix unless other arrangements have been agreed upon.
-* Questions should be posted on talk/discussion pages and signed (use <code><nowiki>-- ~~~~</nowiki></code> to sign comments).
-* Before posting a feature suggestion on the wiki check to see if it has been suggested on [https://jira.secondlife.com/ Jira] first.
-* When posting a script if it is a complete script, it should compile without error and be fully functional or marked otherwise. Code fragments should compile if properly installed into a script (no internal errors in the code fragments).
-* Scripts that are posted should have a consistent style through out the script; whitespace consistency is important.
-* Modern web browsers come with or have available spell checkers. All content should be spell checked before being posted.
 == Footnotes ==
 {{Footnotes}}