커널 개발 community 문서 안내 | Linux 6.18.37

요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.

1. 요약·해설

원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.

커널 개발자가 되려는 독자에게

index.rst:1-16

Linux kernel 개발에 참여하려면 기술 지식뿐 아니라 community가 일하는 방식을 알아야 한다. 이 process 문서 묶음은 변경을 불필요한 마찰 없이 review받고 merge하는 데 필요한 관행을 설명한다.

개발 절차 입문

index.rst:18-31

howto: kernel 개발 참여를 위한 전체 안내
development-process: 설계부터 merge 이후까지의 개발 lifecycle
submitting-patches: patch 제출의 상세 규칙
submit-checklist: 게시 직전 점검 목록

도구와 기술 지침

index.rst:33-51

Build 요구사항, kernel programming language, coding style, maintainer PGP, email client, patch 적용과 backport, system call 추가, volatile 사용과 ioctl 설계 문제를 다룬다.

Policy와 developer statement

index.rst:53-72

License, code of conduct, contribution maturity, enforcement와 driver statement, stable API·stable kernel 규칙, management style과 security researcher 지침처럼 community가 지키려는 원칙을 모은다.

Bug 처리

index.rst:74-90

일반 debugging과 함께 regression, security bug, CVE, 공개 전 embargo가 필요한 hardware issue를 처리하는 policy를 설명한다.

Maintainer와 기타 자료

index.rst:92-118

Patch를 받아 줄 사람을 찾기 위한 maintainer handbook과 maintainer 정보, 추가 kernel 문서 안내와 deprecated API·기능 목록으로 연결한다.

2. 영어 원문 전체

번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.

원문 전체 펼치기

1 .. raw:: latex

3 \renewcommand\thesection*

4 \renewcommand\thesubsection*

6 .. _process_index:

8 =============================================

9 Working with the kernel development community

10 =============================================

12 So you want to be a Linux kernel developer? Welcome! While there is a lot

13 to be learned about the kernel in a technical sense, it is also important

14 to learn about how our community works. Reading these documents will make

15 it much easier for you to get your changes merged with a minimum of

16 trouble.

18 An introduction to how kernel development works

19 -----------------------------------------------

21 Read these documents first: an understanding of the material here will ease

22 your entry into the kernel community.

24 .. toctree::

25 :maxdepth: 1

27 howto

28 development-process

29 submitting-patches

30 submit-checklist

32 Tools and technical guides for kernel developers

33 ------------------------------------------------

35 This is a collection of material that kernel developers should be familiar

36 with.

38 .. toctree::

39 :maxdepth: 1

41 changes

42 programming-language

43 coding-style

44 maintainer-pgp-guide

45 email-clients

46 applying-patches

47 backporting

48 adding-syscalls

49 volatile-considered-harmful

50 botching-up-ioctls

52 Policy guides and developer statements

53 --------------------------------------

55 These are the rules that we try to live by in the kernel community (and

56 beyond).

58 .. toctree::

59 :maxdepth: 1

61 license-rules

62 code-of-conduct

63 code-of-conduct-interpretation

64 contribution-maturity-model

65 kernel-enforcement-statement

66 kernel-driver-statement

67 stable-api-nonsense

68 stable-kernel-rules

69 management-style

70 researcher-guidelines

72 Dealing with bugs

73 -----------------

75 Bugs are a fact of life; it is important that we handle them properly. The

76 documents below provide general advice about debugging and describe our

77 policies around the handling of a couple of special classes of bugs:

78 regressions and security problems.

80 .. toctree::

81 :maxdepth: 1

83 debugging/index

84 handling-regressions

85 security-bugs

86 cve

87 embargoed-hardware-issues

89 Maintainer information

90 ----------------------

92 How to find the people who will accept your patches.

94 .. toctree::

95 :maxdepth: 1

97 maintainer-handbooks

98 maintainers

100 Other material

101 --------------

102

103 Here are some other guides to the community that are of interest to most

104 developers:

105

106 .. toctree::

107 :maxdepth: 1

108

109 kernel-docs

110 deprecated

111

112 .. only:: subproject and html

113

114 Indices

115 =======

116

117 * :ref:`genindex`

118

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.

문서 형식과 kernel 개발 community

1-16

.. raw:: latex

    \renewcommand\thesection*
    \renewcommand\thesubsection*

.. _process_index:

Linux kernel developer가 되고 싶다면 환영한다. Kernel에는 기술적으로 배울 내용이 많지만 community가 어떻게 움직이는지 이해하는 일도 중요하다. 이 문서 묶음을 읽으면 불필요한 문제를 줄이면서 변경 사항을 merge하기가 훨씬 쉬워진다.

Kernel 개발 절차 입문

18-30

다음 문서를 먼저 읽는다. 여기에 담긴 내용을 이해하면 kernel community에 진입하는 과정이 한결 수월하다.

howto
development-process
submitting-patches
submit-checklist

Kernel developer를 위한 도구와 기술 지침

32-50

Kernel developer가 익숙하게 다룰 필요가 있는 자료를 모은 부분이다.

changes
programming-language
coding-style
maintainer-pgp-guide
email-clients
applying-patches
backporting
adding-syscalls
volatile-considered-harmful
botching-up-ioctls

정책 지침과 developer 성명

52-70

Kernel community 안팎에서 구성원이 따르려고 노력하는 규칙을 모은 부분이다.

license-rules
code-of-conduct
code-of-conduct-interpretation
contribution-maturity-model
kernel-enforcement-statement
kernel-driver-statement
stable-api-nonsense
stable-kernel-rules
management-style
researcher-guidelines

버그 처리

72-87

버그는 개발 과정에서 피할 수 없다. 중요한 것은 버그를 올바르게 처리하는 일이다. 아래 문서는 일반적인 debugging 방법을 안내하고 regression과 security problem이라는 특수한 두 부류의 버그를 처리하는 정책을 설명한다.

debugging/index
handling-regressions
security-bugs
cve
embargoed-hardware-issues

Maintainer 정보

89-98

작성한 patch를 받아들일 사람을 찾는 방법을 설명한다.

maintainer-handbooks
maintainers

그 밖의 자료와 색인

100-117

대부분의 developer가 참고할 만한 그 밖의 community 지침으로 kernel-docs와 deprecated 문서를 제공한다.

kernel-docs
deprecated

이 문서를 HTML subproject로 빌드할 때는 일반 색인인 genindex도 함께 표시한다.