Documentation
주제 범위
수색…
소개
주제는 가능한 한 간단하게 만들어야하지만 더 간단하지는 않습니다. 이것은 Stack Overflow Documentation에서 볼 수있는 몇 가지 조직 원리를 제안합니다.
언어 기능 항목
자연적인 구분은 단순히 각 언어 기능에 대해 하나의 주제를 만드는 것입니다. 예를 들어, 파이썬 은 :
- 수업
- 기능들
- 발전기
- 장식 자
- . . .
단점은 기능이 매우 복잡 할 수 있으며 단일 페이지에 대해 이해하는 것보다 더 많은 예제를 제시하기 쉽습니다. 클래스 에는 16 개의 예가 있습니다. 그 중 일부는 상속, 속성, 메소드 등과 같은 다른 기능 주제로 이동할 수 있습니다.
잡아 가방 주제
일부 주제는 C # 6.0 기능 및 일반적인 함정 과 같은 테마에서 느슨하게 연관된 예제입니다. 콘텐츠 추가를 중단 할 자연스러운 장소가 없으므로 주제별 예제가 제한적 이므로 전체적으로이 주제 스타일은 권장되지 않습니다.
예제를 다른 주제 (아마도 언어 기능 )로 이동하는 것이 좋습니다. 이 일을 보지 못했지만이 주제가 다른 주제 또는 예제에 대한 링크로 구성된 예제를 포함하는 메타 주제로 변환 될 수 있습니다.
펄 팁과 트릭
- XML을 정규식으로 구문 분석하지 마십시오! XML 구문 분석 모듈을 사용하십시오.
- 전체 코드 블록을 주석 처리해야하는 경우 POD 주석 블록을 사용하십시오 .
- . . .
Modified text is an extract of the original Stack Overflow Documentation
아래 라이선스 CC BY-SA 3.0
와 제휴하지 않음 Stack Overflow