# 문서 자료

이 문서는 Nix, Nixpkgs, NixOS의 문서 자료를 개괄하고, 이를 개선하는 데 도움을 줄 수 있는 방법을 제안합니다.

## 참조 매뉴얼

참조 매뉴얼은 인터페이스와 동작을 문서화하고, 예제를 보여 주며, 구성 요소별 용어를 정의합니다.

- [Nix 참조 매뉴얼](nix-manual)
  - [소스](https://github.com/NixOS/nix/tree/master/doc/manual)
  - [이슈](https://github.com/NixOS/nix/issues?q=is%3Aopen+is%3Aissue+label%3Adocumentation)
  - [풀 리퀘스트](https://github.com/NixOS/nix/pulls?q=is%3Aopen+is%3Apr+label%3Adocumentation)
- [Nixpkgs 참조 매뉴얼](https://nixos.org/manual/nixpkgs)
  - [소스](https://github.com/NixOS/nixpkgs/tree/master/doc)
  - [이슈](https://github.com/NixOS/nixpkgs/issues?q=is%3Aopen+is%3Aissue+label%3A%226.topic%3A+documentation%22+-label%3A%226.topic%3A+nixos%22)
  - [풀 리퀘스트](https://github.com/NixOS/nixpkgs/pulls?q=is%3Aopen+is%3Apr+label%3A%226.topic%3A+documentation%22+-label%3A%226.topic%3A+nixos%22)
- [NixOS 참조 매뉴얼](https://nixos.org/manual/nixos)
  - [소스](https://github.com/NixOS/nixpkgs/tree/master/nixos/doc/manual)
  - [이슈](https://github.com/NixOS/nixpkgs/issues?q=is%3Aopen+is%3Aissue+label%3A%226.topic%3A+documentation%22+label%3A%226.topic%3A+nixos%22+)
  - [풀 리퀘스트](https://github.com/NixOS/nixpkgs/pulls?q=is%3Aopen+is%3Apr+label%3A%226.topic%3A+documentation%22+label%3A%226.topic%3A+nixos%22+)

각 매뉴얼 섹션은 문서화 대상 코드의 개발자가 관리합니다.

도울 수 있는 방법:

- 이름만 언급된 정의, 명령, 옵션 등에 링크를 추가하십시오
- 기술 용어를 일관되게 사용하도록 하십시오
- 예제가 그 자체로 완결되어 있고 모범 사례를 따르는지 확인하십시오
- 불완전해 보이는 섹션을 보완하십시오

## NixOS 위키

[NixOS 위키](https://wiki.nixos.org/)는 NixOS 사용자 가이드, 설정 예제, 문제 해결 팁을 모아 놓은 곳입니다. NixOS 참조 매뉴얼을 보완하기 위한 것입니다.

NixOS 사용자 커뮤니티가 공동으로 편집합니다.

도울 수 있는 방법:

- 분류와 참조 문서 링크를 추가하여 찾기 쉽게 만드십시오
- 중복되거나 오래된 정보를 제거하십시오
- 여러분의 사용 사례에 맞는 가이드와 예시 설정을 추가하십시오

## nix.dev

[nix.dev](https://nix.dev)([소스](https://github.com/nixos/nix.dev))의 목적은 초보자가 Nix 생태계에서 방향을 잡도록 안내하는 것입니다.

문서 팀은 편집자로서 nix.dev를 유지 관리합니다.

도울 수 있는 방법:

- [열린 이슈](https://github.com/nixos/nix.dev/issues)를 해결하십시오
- [풀 리퀘스트](https://github.com/nixos/nix.dev/pulls)를 리뷰하십시오
- [제안된 개요](https://github.com/NixOS/nix.dev/issues/572)에 따라 가이드나 튜토리얼을 추가하십시오. 새 글은 다음과 같은 영상을 바탕으로 작성할 수 있습니다:

  - [The Nix Hour](https://www.youtube.com/watch?v=wwV1204mCtE&list=PLyzwHTVJlRc8yjlx4VR4LU5A5O44og9in) 녹화 영상
  - 약 100개의 [NixCon](https://www.youtube.com/c/NixCon) 녹화 영상 중 일부
  - @jonringer의 [Nix 영상 가이드](https://www.youtube.com/user/elitespartan117j27)
  - [Summer of Nix 2022 발표](https://www.youtube.com/playlist?list=PLt4-_lkyRrOMWyp5G-m_d1wtTcbBaOxZk)

  가이드나 튜토리얼을 작성하려면 많은 노력이 들기 때문에, 이슈에 댓글을 달거나 새 이슈를 여는 등의 방법으로 반드시 유지 관리자와 조율하십시오.

## Discourse

Nix 사용자들은 다음 Discourse 카테고리에서 정보를 교환하고 서로 돕습니다:

- [도움말](https://discourse.nixos.org/c/learn/9)
- [가이드](https://discourse.nixos.org/c/howto/15)
- [링크](https://discourse.nixos.org/c/links/12)

도울 수 있는 방법:

- 충분히 알아본 뒤 질문하고, 시도한 내용을 보여 주십시오
- 다른 사람들의 질문에 답하십시오
- NixOS 위키 문서, nix.dev 가이드나 튜토리얼, 또는 참조 매뉴얼 중 하나를 업데이트하거나 추가하여 반복되는 질문을 해결하십시오.
- 사람들이 자신의 통찰을 공식 문서에 반영하도록 격려하고 도우십시오

## Nix Pills

[Nix Pills](https://nixos.org/guides/nix-pills/)는 Nix로 소프트웨어 패키지를 빌드하는 방법을 다루는 저수준 튜토리얼 시리즈로, Nixpkgs가 기본 원리부터 어떻게 만들어지는지 자세히 보여 줍니다.

Nix Pills는 현재 활발히 유지 관리되지 않습니다.