From: ng0 <ng0@infotropique.org>
Date: Fri, 3 Nov 2017 07:57:29 +0000 (+0000)
Subject: doc README
X-Git-Tag: gnunet-0.11.0rc0~98^2~16
X-Git-Url: https://git.librecmc.org/?a=commitdiff_plain;h=6bf7f40bfa6a9c3f2d1a046954de7ec09aeb1f97;p=oweals%2Fgnunet.git

doc README
---

diff --git a/doc/documentation/README.txt b/doc/documentation/README.txt
index 6a34509a7..c3dda87c5 100644
--- a/doc/documentation/README.txt
+++ b/doc/documentation/README.txt
@@ -22,6 +22,13 @@ To be moved to an appropriate section of "how to write documentation" or
 
      We do this and the other thing.  This is done by foo.
 
+6. Use @footnote{} instead of putting an @*ref{} to the footnote on a
+   collected footnote-page.
+   In a 200+ pages handbook it's better to have footnotes accessible
+   without having to skip over to the end.
+
+6.1 Avoid unnecessary footnotes, keep the text self-explanatory and
+    in a simple language where possible/necessary.
 
 * Completion Levels: