Community Wishlist/Wishes/Document ALL the modules!/ko
모든 모듈을 문서화하세요! Open
Description
대부분 모듈은 많이 사용됨에도 불구하고 문서가 거의 없거나 전혀 없습니다. "정말 나쁩니다"! 위키미디어에서도 다른 곳과 마찬가지로 문서화되지 않은 프로덕션에 중요한 코드가 대량으로 있는 것은 "무섭습니다"!
가장 많이 사용되는 모듈의 몇 가지 예:
- 영어 위키백과에서:
- 모듈 wikipedia:Module:Message box은 wikipedia:Template:Ambox, wikipedia:Template:Tmbox 등을 구현하는데, 이는 다시 모든 유지 관리 템플릿을 구현하고, 이 템플릿은 다시 위키백과에서 볼 수 있는 모든 상자 메시지를 구현합니다. 예를 들어 "다중 문제" 경고, 백로그 알림 등을 들 수 있습니다.
- 모듈 wikipedia:Module:Citation/CS1은 "모든" 인용 템플릿을 구현하는데, 이는 위키백과의 모든 문서 대부분에서 사용됩니다.
- 영어 위키문헌에서 모듈 wikisource:Module:Monthly Challenge listing 목록은 월별 챌린지를 구현하는데, 이는 위키문헌이 교정 과정을 게임화하는 방식입니다. 그러나 문서는 전혀 없습니다.
모듈을 문서화하는 데는 세 가지 큰 걸림돌이 있습니다. 첫째, 일반적으로 모듈은 하나 이상의 래퍼 템플릿이나 메타템플릿에서 사용됩니다. 그런 다음 템플릿은 상당히 광범위하게 문서화되지만 모듈은 상대적으로 잊혀집니다. 둘째, 템플릿데이터 확장 프로그램을 사용하면 템플릿은 문서화할 수 있지만 모듈은 문서화할 수 없습니다. 셋째, 미디어위키 모듈은 루아로 작성해야 하며 루아로 코드를 유창하게 읽거나 쓸 수 있는 사람은 매우 적습니다(저는 그런 사람이 아닙니다). 루아는 파이썬이나 자바스크립트와 같은 더 인기 있는 언어에 비해 매우 드문 프로그래밍 언어입니다.
사용자가 모든 모듈을 문서화할 수 있는 기능과 모든 문서 페이지를 "실제로 작성"할 수 있는 위키미디어 전체의 추진이 매우 유용할 것입니다.
Assigned focus area
Unassigned.
Type of wish
Feature request
Related projects
All projects
Affected users
모든 모듈 및 템플릿 편집기
Other details
- Created: 05:25, 26 August 2024 (UTC)
- Last updated: 15:17, 3 9월 2024 (UTC)
- Author: Duckmather (talk)