LSL Portal Guidelines/pt

From Second Life Wiki
Jump to navigation Jump to search

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

Style

  1. LSL Category Style - Usado para categorizar grupos de funções LSL e outras Tabelas de Conteúdos.
  2. LSL Function Style - Usado para a especificação completa de todas as funções LSL.
  3. LSL Topic Style - Usado para tópicos de interesse relacionados ao uso do LSL (XML-RPC, quatérnions, etc).
  4. 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.

Notas de Rodapé

  1. ^ Derived from the open sentences of the LSL Portal.