Confusion between fetchers implemented by builtins and by nixpkgs.

Đang mở
#1,190 2 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
1/5
Thời gian dự kiến
Dưới một giờ
Mức phù hợp với người mới
55/100
Loại issue
Tài liệu
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Đình trệ
Lĩnh vực
documentation

Hướng nghiên cứu

Bắt đầu với phần Fetchers trong hướng dẫn Nix Language Basics và so sánh ghi chú của phần này với Nixpkgs Manual và cuộc thảo luận Discourse được liên kết. Cập nhật ghi chú để người đọc có thể phân biệt các fetcher tích hợp sẵn của Nix với các fetcher của nixpkgs, hiểu rằng các cách triển khai khác nhau và biết rằng chúng không thể được hoán đổi trực tiếp.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

site

Observations
A note in the section on Fetchers in the Chapter Nix Language Basics, refers to the Nixpkgs Manual on Fetchers but doesnt provide the information that these are distinct from the fetchers built into Nix by default and also have considerable differences.

Relevant Section:
https://nix.dev/tutorials/nix-language#fetchers

See:
https://discourse.nixos.org/t/builtins-fetchurl-vs-nixpkgs-fetchurl/24133

Problem
This can cause confusion as to, if the manual describes the builtin Fetchers or describes Fetchers implemented by nixpkgs. (Atleast it did to me)

Approaches
Make it clear in the note that nixpkgs implements their own fetchers and also additional fetchers over the builtin fetchers. Also note that Fetcher implementations differ and they cant be just interchanged.

Willing to help?
I could make the change I suppose. I have not made any opensource contribution yet, but I like Nix and this guide and I am open to it.

Priorities

Add 👍 to issues you find important.

Ngôn ngữ chính
Nix
Star
4k
Fork
343
Merge trung bình
1 ngày 12 giờ
Pull request đã merge (30 ngày)
14

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của NixOS/nix.dev

Tất cả issue của NixOS/nix.dev

Issue tương tự

Thêm issue về Documentation

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.