From 86ea612b1538f551f82dad6a1cee2a3ce61ed842 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?C=C3=A9lestin=20Matte?= <dev@cmatte.me>
Date: Wed, 5 Nov 2025 17:45:36 +0100
Subject: [PATCH] Add documentation about RNG sources

---
 docs/guides/rng.md | 26 ++++++++++++++++++++++++++
 docs/help.md       |  1 +
 2 files changed, 27 insertions(+)
 create mode 100644 docs/guides/rng.md

diff --git a/docs/guides/rng.md b/docs/guides/rng.md
new file mode 100644
index 00000000..40cdcd62
--- /dev/null
+++ b/docs/guides/rng.md
@@ -0,0 +1,26 @@
+---
+layout: page
+title: RNG sources
+permalink: /rng/
+---
+
+This page list possible sources that games may use for their Random Number Generator (RNG), and which options control them in libTAS.
+
+* TOC
+{:toc}
+
+## Sources
+
+Besides of the [regular in-game sources of randomness](https://tasvideos.org/LuckManipulation), games may get data from other sources to update their PRNG. Some of these sources are configurable, while libTAS provides fixed values for others.
+
+For more information about these different sources, see [the Tech details page](how).
+
+### Configurable
+
+* System time: can be configured on the main window
+
+### Currently not configurable
+
+* reading `/proc/cputime`
+* using the current process pid
+* reading `/dev/urandom`
diff --git a/docs/help.md b/docs/help.md
index 3caaeb75..f3f7c192 100644
--- a/docs/help.md
+++ b/docs/help.md
@@ -12,3 +12,4 @@ get help from the [Discord server](https://discord.gg/3MBVAzU).
 * [Lua usage and functions](../guides/lua)
 * [Moviefile format](../guides/format)
 * [Tech details](../guides/how)
+* [Sources of randomness](../guides/rng)