# HG changeset patch
# User Arne Babenhauserheide <arne_bab@web.de>
# Date 1703964126 -3600
#      Sat Dec 30 20:22:06 2023 +0100
# Node ID a38fc058d3e612bcb28a80d22d60b4f4416ccce1
# Parent  0578c5b070b21be1defa9f833656ab0620a4cc4d
HOWTO: add indirect trust aggregation and not distrusting ancestors

diff --git a/HOWTO.org b/HOWTO.org
--- a/HOWTO.org
+++ b/HOWTO.org
@@ -145,9 +145,10 @@
 #+RESULTS:
 : 50
 
+*Note: The keys are not guaranteed to be stable, because pruning the trust data can change them. If you get a 500 when requesting the score, you may have to update the keys.*
+
 OTHERID to BADID: First get the keys:
 
-
 #+begin_src http :pretty :exports both
 GET http://127.0.0.1:4280/key/OTHERID
 #+end_src
@@ -164,7 +165,6 @@
 
 Then request the score for these keys:
 
-
 #+begin_src http :pretty :exports both
 GET http://127.0.0.1:4280/score/ownkey/0001/otherkey/0004
 #+end_src
@@ -221,6 +221,46 @@
 #+RESULTS:
 : 20
 
+Increasing intermediate trust can make the score of an ID someone
+distrusts net-positive:
+
+#+begin_src http :pretty :exports both
+PUT http://127.0.0.1:4280/trust/SOMEID
+Content-type: application/x-www-form-urlencoded
+
+100=OTHERID&30=ONEMOREID
+#+end_src
+
+#+RESULTS:
+
+=application/x-www-form-urlencoded= format:
+
+#+begin_src http :pretty :exports both
+PUT http://127.0.0.1:4280/trust/ONEMOREID
+Content-type: application/x-www-form-urlencoded
+
+10=BADID
+#+end_src
+
+#+begin_src http :pretty :exports both
+GET http://127.0.0.1:4280/score/ownkey/0000/otherkey/0004
+#+end_src
+
+#+RESULTS:
+
+But it cannot impact the score of IDs that are closer in the
+trust-graph (cannot cause an ancestor to become distrusted).
+
+#+begin_src http :pretty :exports both
+GET http://127.0.0.1:4280/score/ownkey/0000/otherkey/0002
+#+end_src
+
+#+RESULTS:
+: 20
+
+
+
+
 You receive either an empty result, when there is no known connection,
 or an integer-value.