about summary refs log tree commit diff
path: root/doc
diff options
context:
space:
mode:
authorgithub-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>2023-10-03 00:12:01 +0000
committerGitHub <noreply@github.com>2023-10-03 00:12:01 +0000
commitea0284a3da391822909be5e98a60c1e62572a7dc (patch)
tree2d73786887cabdc676204f5d9ad0df9055391021 /doc
parent4ad7a433efd93246ebf3113ac8247c4fadd0683e (diff)
parente5e88c99f3b322b4b6df22740d68d58f8db9b941 (diff)
Merge master into haskell-updates
Diffstat (limited to 'doc')
-rw-r--r--doc/using-nixpkgs.md1
-rw-r--r--doc/using/platform-support.chapter.md18
2 files changed, 19 insertions, 0 deletions
diff --git a/doc/using-nixpkgs.md b/doc/using-nixpkgs.md
index bb222ae384fa6..f850b2e83c28d 100644
--- a/doc/using-nixpkgs.md
+++ b/doc/using-nixpkgs.md
@@ -1,6 +1,7 @@
 # Using Nixpkgs {#part-using}
 
 ```{=include=} chapters
+using/platform-support.chapter.md
 using/configuration.chapter.md
 using/overlays.chapter.md
 using/overrides.chapter.md
diff --git a/doc/using/platform-support.chapter.md b/doc/using/platform-support.chapter.md
new file mode 100644
index 0000000000000..3f91b3d5d9808
--- /dev/null
+++ b/doc/using/platform-support.chapter.md
@@ -0,0 +1,18 @@
+# Platform Support {#chap-platform-support}
+
+Packages receive varying degrees of support, both in terms of maintainer attention and available computation resources for continuous integration (CI).
+
+Below is the list of the best supported platforms:
+
+- `x86_64-linux`: Highest level of support.
+- `aarch64-linux`: Well supported, with most packages building successfully in CI.
+- `aarch64-darwin`: Receives better support than `x86_64-darwin`.
+- `x86_64-darwin`: Receives some support.
+
+There are many other platforms with varying levels of support.
+The provisional platform list in [Appendix A] of [RFC046], while not up to date, can be used as guidance.
+
+A more formal definition of the platform support tiers is provided in [RFC046], but has not been fully implemented yet.
+
+[RFC046]: https://github.com/NixOS/rfcs/blob/master/rfcs/0046-platform-support-tiers.md
+[Appendix A]: https://github.com/NixOS/rfcs/blob/master/rfcs/0046-platform-support-tiers.md#appendix-a-non-normative-description-of-platforms-in-november-2019