NixOS/nix

List and document experimental features in one place

Open

#8,466 opened on 2023年6月7日

GitHub で見る
 (9 comments) (3 reactions) (0 assignees)C++ (9,803 stars) (1,293 forks)batch import
documentationgood first issue

説明

Problem

Currently experimental features are listed in the setting experimental-features, but documented in detail on a rather explanation-style page aimed at contributors.

Proposal

The second should not have that listing at all because it's unrelated, and the listing in the setting should contain the details.

Checklist

Priorities

Add :+1: to issues you find important.

コントリビューターガイド

技術スタック
なし
領域
documentation
Issue 種別
documentation
難度新しい貢献者にとっての実装難度です。1 は非常に小さな変更、5 は専門的な作業です。
2
推定時間経験ある貢献者が調査、実装、テスト、pull request 準備にかけるおおよその時間範囲です。
half day
活動状況Issue が今どれだけ取り組みやすいかを示します。新しい、活発、古い、ブロック中、またはメンテナー入力待ちなどです。
active
明確さ期待される変更、受け入れ条件、次の手順がどれだけ明確かを示します。
clear
前提条件
Familiarity with NixKnowledge of Nix's experimental featuresUnderstanding of Nix documentation structure
初心者向け度初回貢献者にどれだけ取り組みやすいかを 1-100 で推定したスコアです。
85
調査方針
Examine the current documentation: the experimental features are listed in the Nix manual under settings (experimental features) and also explained in a separate contributor page. The goal is to consolidate: remove the listing from the contributor page and enrich the settings documentation with details from the explanation page. Start by reading the existing files in doc/manual/src, particularly the settings documentation and the experimental features page. Look at the discussion in the issue comments for any specific suggestions. The deliverable is a PR that reorganizes these sections.