LSL Portal Guidelines/ko

From Second Life Wiki
Jump to navigation Jump to search

이 페이지는 LSL 위키를 편집하고 글을 쓸 때의 기본 지침을 정의해 놓은 것이다.

LSL 포털에 대하여

사명

"LSL에 관한 정확한 문서화를 제공한다."[1]

목표

"모든 수준의 개발자들에게 도움이 될 수 있는 문서를 제공한다."[1]

안내

양식

  1. LSL Category Style - LSL 함수나 다른 목차들의 범주화를 위한 양식.
  2. LSL Function Style - LSL 함수의 완전한 명세를 기술하기 위한 양식.
  3. LSL Topic Style - LSL과 관련있는 흥미로운 주제에 대해 따로 기술할 때 사용(XML-RPC, 사원수 등).
  4. LSL Constants Style - 정수의 문서화를 위한 양식.

지침

  • LSL 포털 자체와 그 분류를 위한 페이지들은 접두어 'LSL'로 시작되어야 한다.
  • 그 외 혹시 존재할지도 모르는, LSL 접두어로 시작되는 다른 문서들은 문서화에 대한 다른 규칙이 합의되기 전 까지는 LSL접두어를 모두 삭제하도록 한다.
  • 질문은 개별 쪽의 talk/discussion에 작성하고 서명한다(-- ~~~~을 삽입하면 자동으로 서명된다).
  • 기능 제안에 대한 글을 쓰기 전에 Jira에 이미 제안된 내용인지를 먼저 확인하라.
  • 스크립트를 올릴 때는 오류없이 제대로 컴파일되는지, 그리고 충분히 본보기로 내보일 특징이 있고 기능적인지를 검토해야한다. 코드 조각은 스크립트 내부에 넣었을 때 문제없이 컴파일되어야 한다(코드 조각 자체에 오류가 없어야 한다).
  • 스크립트는 일관성 있는 양식으로 작성되어야 한다. 들여쓰기를 잘 지키는 것이 중요하다.
  • 최근의 웹브라우저들은 적당한 철자 확인 도구를 제공한다. 제출하기 전에 글월의 맞춤법이 올바른지 확인해야 한다.
  • 한국어 화면을 작성/번역할 때에는 올바른 문장 및 어휘를 사용해야한다. 세컨드라이프 국어순화어를 참고할 것.