update docs

1 files changed, 1 insertions, 0 deletions

diff --git a/images/evaluators-reading.svg b/images/evaluators-reading.svg
new file mode 100644
index 0000000..29917bb
--- /dev/null
+++ b/images/evaluators-reading.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" contentStyleType="text/css" data-diagram-type="SEQUENCE" height="565px" preserveAspectRatio="none" style="width:1056px;height:565px;background:#FFFFFF;" version="1.1" viewBox="0 0 1056 565" width="1056px" zoomAndPan="magnify"><?plantuml 1.2026.3?><defs/><g><g class="participant-lifeline" data-entity-uid="part1" data-qualified-name="Client" data-source-line="1" id="part1-lifeline"><g><title>Client</title><rect fill="#000000" fill-opacity="0.00000" height="401.0371" width="8" x="23.7524" y="81.4883"/><line style="stroke:#181818;stroke-width:0.5;stroke-dasharray:5,5;" x1="27" x2="27" y1="81.4883" y2="482.5254"/></g></g><g class="participant-lifeline" data-entity-uid="part2" data-qualified-name="Path" data-source-line="2" id="part2-lifeline"><g><title>Path.lookup</title><rect fill="#000000" fill-opacity="0.00000" height="401.0371" width="8" x="264.6138" y="81.4883"/><line style="stroke:#181818;stroke-width:0.5;stroke-dasharray:5,5;" x1="268.2373" x2="268.2373" y1="81.4883" y2="482.5254"/></g></g><g class="participant-lifeline" data-entity-uid="part3" data-qualified-name="Multigroup" data-source-line="3" id="part3-lifeline"><g><title>Multigroup</title><rect fill="#000000" fill-opacity="0.00000" height="401.0371" width="8" x="366.3076" y="81.4883"/><line style="stroke:#181818;stroke-width:0.5;stroke-dasharray:5,5;" x1="369.9902" x2="369.9902" y1="81.4883" y2="482.5254"/></g></g><g class="participant-lifeline" data-entity-uid="part4" data-qualified-name="E" data-source-line="4" id="part4-lifeline"><g><title>EphemeralRelation</title><rect fill="#000000" fill-opacity="0.00000" height="401.0371" width="8" x="636" y="81.4883"/><line style="stroke:#181818;stroke-width:0.5;stroke-dasharray:5,5;" x1="639.8667" x2="639.8667" y1="81.4883" y2="482.5254"/></g></g><g class="participant-lifeline" data-entity-uid="part5" data-qualified-name="Program" data-source-line="5" id="part5-lifeline"><g><title>Program</title><rect fill="#000000" fill-opacity="0.00000" height="401.0371" width="8" x="834.7192" y="81.4883"/><line style="stroke:#181818;stroke-width:0.5;stroke-dasharray:5,5;" x1="838.0562" x2="838.0562" y1="81.4883" y2="482.5254"/></g></g><g class="participant-lifeline" data-entity-uid="part6" data-qualified-name="Ev" data-source-line="6" id="part6-lifeline"><g><title>evaluator under</title><rect fill="#000000" fill-opacity="0.00000" height="401.0371" width="8" x="966.2104" y="81.4883"/><line style="stroke:#181818;stroke-width:0.5;stroke-dasharray:5,5;" x1="969.9023" x2="969.9023" y1="81.4883" y2="482.5254"/></g></g><g class="participant participant-head" data-entity-uid="part1" data-qualified-name="Client" data-source-line="1" id="part1-head"><text fill="#000000" font-family="sans-serif" font-size="14" lengthAdjust="spacing" textLength="39.5049" x="5" y="78.5352">Client</text><ellipse cx="27.7524" cy="13.5" fill="#E2E2F0" rx="8" ry="8" style="stroke:#181818;stroke-width:0.5;"/><path d="M27.7524,21.5 L27.7524,48.5 M14.7524,29.5 L40.7524,29.5 M27.7524,48.5 L14.7524,63.5 M27.7524,48.5 L40.7524,63.5" fill="none" style="stroke:#181818;stroke-width:0.5;"/></g><g class="participant participant-tail" data-entity-uid="part1" data-qualified-name="Client" data-source-line="1" id="part1-tail"><text fill="#000000" font-family="sans-serif" font-size="14" lengthAdjust="spacing" textLength="39.5049" x="5" y="495.0605">Client</text><ellipse cx="27.7524" cy="506.5137" fill="#E2E2F0" rx="8" ry="8" style="stroke:#181818;stroke-width:0.5;"/><path d="M27.7524,514.5137 L27.7524,541.5137 M14.7524,522.5137 L40.7524,522.5137 M27.7524,541.5137 L14.7524,556.5137 M27.7524,541.5137 L40.7524,556.5137" fill="none" style="stroke:#181818;stroke-width:0.5;"/></g><g class="participant participant-head" data-entity-uid="part2" data-qualified-name="Path" data-source-line="2" id="part2-head"><rect fill="#E2E2F0" height="30.4883" rx="2.5" ry="2.5" style="stroke:#181818;stroke-width:0.5;" width="94.7529" x="221.2373" y="50"/><text fill="#000000" font-family="sans-serif" font-size="14" lengthAdjust="spacing" textLength="80.7529" x="228.2373" y="70.5352">Path.lookup</text></g><g class="participant participant-tail" data-entity-uid="part2" data-qualified-name="Path" data-source-line="2" id="part2-tail"><rect fill="#E2E2F0" height="30.4883" rx="2.5" ry="2.5" style="stroke:#181818;stroke-width:0.5;" width="94.7529" x="221.2373" y="481.5254"/><text fill="#000000" font-family="sans-serif" font-size="14" lengthAdjust="spacing" textLength="80.7529" x="228.2373" y="502.0605">Path.lookup</text></g><g class="participant participant-head" data-entity-uid="part3" data-qualified-name="Multigroup" data-source-line="3" id="part3-head"><rect fill="#E2E2F0" height="30.4883" rx="2.5" ry="2.5" style="stroke:#181818;stroke-width:0.5;" width="88.6348" x="325.9902" y="50"/><text fill="#000000" font-family="sans-serif" font-size="14" lengthAdjust="spacing" textLength="74.6348" x="332.9902" y="70.5352">Multigroup</text></g><g class="participant participant-tail" data-entity-uid="part3" data-qualified-name="Multigroup" data-source-line="3" id="part3-tail"><rect fill="#E2E2F0" height="30.4883" rx="2.5" ry="2.5" style="stroke:#181818;stroke-width:0.5;" width="88.6348" x="325.9902" y="481.5254"/><text fill="#000000" font-family="sans-serif" font-size="14" lengthAdjust="spacing" textLength="74.6348" x="332.9902" y="502.0605">Multigroup</text></g><g class="participant participant-head" data-entity-uid="part4" data-qualified-name="E" data-source-line="4" id="part4-head"><rect fill="#E2E2F0" height="30.4883" rx="2.5" ry="2.5" style="stroke:#181818;stroke-width:0.5;" width="140.2666" x="569.8667" y="50"/><text fill="#000000" font-family="sans-serif" font-size="14" lengthAdjust="spacing" textLength="126.2666" x="576.8667" y="70.5352">EphemeralRelation</text></g><g class="participant participant-tail" data-entity-uid="part4" data-qualified-name="E" data-source-line="4" id="part4-tail"><rect fill="#E2E2F0" height="30.4883" rx="2.5" ry="2.5" style="stroke:#181818;stroke-width:0.5;" width="140.2666" x="569.8667" y="481.5254"/><text fill="#000000" font-family="sans-serif" font-size="14" lengthAdjust="spacing" textLength="126.2666" x="576.8667" y="502.0605">EphemeralRelation</text></g><g class="participant participant-head" data-entity-uid="part5" data-qualified-name="Program" data-source-line="5" id="part5-head"><rect fill="#E2E2F0" height="30.4883" rx="2.5" ry="2.5" style="stroke:#181818;stroke-width:0.5;" width="71.3262" x="803.0562" y="50"/><text fill="#000000" font-family="sans-serif" font-size="14" lengthAdjust="spacing" textLength="57.3262" x="810.0562" y="70.5352">Program</text></g><g class="participant participant-tail" data-entity-uid="part5" data-qualified-name="Program" data-source-line="5" id="part5-tail"><rect fill="#E2E2F0" height="30.4883" rx="2.5" ry="2.5" style="stroke:#181818;stroke-width:0.5;" width="71.3262" x="803.0562" y="481.5254"/><text fill="#000000" font-family="sans-serif" font-size="14" lengthAdjust="spacing" textLength="57.3262" x="810.0562" y="502.0605">Program</text></g><g class="participant participant-head" data-entity-uid="part6" data-qualified-name="Ev" data-source-line="6" id="part6-head"><rect fill="#E2E2F0" height="46.9766" rx="2.5" ry="2.5" style="stroke:#181818;stroke-width:0.5;" width="150.6162" x="894.9023" y="33.5117"/><text fill="#000000" font-family="sans-serif" font-size="14" lengthAdjust="spacing" textLength="106.9551" x="916.7329" y="54.0469">evaluator under</text><text fill="#000000" font-family="sans-serif" font-size="14" lengthAdjust="spacing" textLength="136.6162" x="901.9023" y="70.5352">the program's name</text></g><g class="participant participant-tail" data-entity-uid="part6" data-qualified-name="Ev" data-source-line="6" id="part6-tail"><rect fill="#E2E2F0" height="46.9766" rx="2.5" ry="2.5" style="stroke:#181818;stroke-width:0.5;" width="150.6162" x="894.9023" y="481.5254"/><text fill="#000000" font-family="sans-serif" font-size="14" lengthAdjust="spacing" textLength="106.9551" x="916.7329" y="502.0605">evaluator under</text><text fill="#000000" font-family="sans-serif" font-size="14" lengthAdjust="spacing" textLength="136.6162" x="901.9023" y="518.5488">the program's name</text></g><g class="message" data-entity-1="part1" data-entity-2="part2" data-source-line="8" id="msg1"><polygon fill="#181818" points="256.6138,108.7988,266.6138,112.7988,256.6138,116.7988,260.6138,112.7988" style="stroke:#181818;stroke-width:1;"/><line style="stroke:#181818;stroke-width:1;" x1="27.7524" x2="262.6138" y1="112.7988" y2="112.7988"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="216.8613" x="34.7524" y="108.0566">lookup a relation in a branch state</text></g><g class="message" data-entity-1="part2" data-entity-2="part3" data-source-line="9" id="msg2"><polygon fill="#181818" points="358.3076,138.1094,368.3076,142.1094,358.3076,146.1094,362.3076,142.1094" style="stroke:#181818;stroke-width:1;"/><line style="stroke:#181818;stroke-width:1;" x1="268.6138" x2="364.3076" y1="142.1094" y2="142.1094"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="37.521" x="275.6138" y="137.3672">find it</text></g><g class="message" data-entity-1="part3" data-entity-2="part4" data-source-line="10" id="msg3"><polygon fill="#181818" points="628,167.4199,638,171.4199,628,175.4199,632,171.4199" style="stroke:#181818;stroke-width:1;"/><line style="stroke:#181818;stroke-width:1;" x1="370.3076" x2="634" y1="171.4199" y2="171.4199"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="245.6924" x="377.3076" y="166.6777">load (evaluator name, source, heading)</text></g><g class="message" data-entity-1="part4" data-entity-2="part5" data-source-line="11" id="msg4"><polygon fill="#181818" points="826.7192,196.7305,836.7192,200.7305,826.7192,204.7305,830.7192,200.7305" style="stroke:#181818;stroke-width:1;"/><line style="stroke:#181818;stroke-width:1;" x1="640" x2="832.7192" y1="200.7305" y2="200.7305"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="114.7148" x="647" y="195.9883">Program.load root</text></g><g class="message" data-entity-1="part5" data-entity-2="part6" data-source-line="12" id="msg5"><polygon fill="#181818" points="958.2104,226.041,968.2104,230.041,958.2104,234.041,962.2104,230.041" style="stroke:#181818;stroke-width:1;"/><line style="stroke:#181818;stroke-width:1;" x1="838.7192" x2="964.2104" y1="230.041" y2="230.041"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="80.5645" x="845.7192" y="225.2988">parse source</text></g><g class="message" data-entity-1="part6" data-entity-2="part5" data-source-line="13" id="msg6"><polygon fill="#181818" points="849.7192,255.3516,839.7192,259.3516,849.7192,263.3516,845.7192,259.3516" style="stroke:#181818;stroke-width:1;"/><line style="stroke:#181818;stroke-width:1;stroke-dasharray:2,2;" x1="843.7192" x2="969.2104" y1="259.3516" y2="259.3516"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="27.606" x="855.7192" y="254.6094">kind</text></g><g class="message" data-entity-1="part4" data-entity-2="part1" data-source-line="14" id="msg7"><polygon fill="#181818" points="38.7524,284.6621,28.7524,288.6621,38.7524,292.6621,34.7524,288.6621" style="stroke:#181818;stroke-width:1;"/><line style="stroke:#181818;stroke-width:1;stroke-dasharray:2,2;" x1="32.7524" x2="639" y1="288.6621" y2="288.6621"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="193.7241" x="44.7524" y="283.9199">relation wrapping the program</text></g><g class="message" data-entity-1="part1" data-entity-2="part4" data-source-line="15" id="msg8"><polygon fill="#181818" points="628,313.9727,638,317.9727,628,321.9727,632,317.9727" style="stroke:#181818;stroke-width:1;"/><line style="stroke:#181818;stroke-width:1;" x1="27.7524" x2="634" y1="317.9727" y2="317.9727"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="67.3613" x="34.7524" y="313.2305">enumerate</text></g><g class="message" data-entity-1="part4" data-entity-2="part5" data-source-line="16" id="msg9"><polygon fill="#181818" points="826.7192,343.2832,836.7192,347.2832,826.7192,351.2832,830.7192,347.2832" style="stroke:#181818;stroke-width:1;"/><line style="stroke:#181818;stroke-width:1;" x1="640" x2="832.7192" y1="347.2832" y2="347.2832"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="174.7192" x="647" y="342.541">invoke ~within:branch state</text></g><g class="message" data-entity-1="part5" data-entity-2="part6" data-source-line="17" id="msg10"><polygon fill="#181818" points="958.2104,372.5938,968.2104,376.5938,958.2104,380.5938,962.2104,376.5938" style="stroke:#181818;stroke-width:1;"/><line style="stroke:#181818;stroke-width:1;" x1="838.7192" x2="964.2104" y1="376.5938" y2="376.5938"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="107.4912" x="845.7192" y="371.8516">eval kind ~within</text></g><g class="message" data-entity-1="part6" data-entity-2="part5" data-source-line="18" id="msg11"><polygon fill="#181818" points="849.7192,401.9043,839.7192,405.9043,849.7192,409.9043,845.7192,405.9043" style="stroke:#181818;stroke-width:1;"/><line style="stroke:#181818;stroke-width:1;stroke-dasharray:2,2;" x1="843.7192" x2="969.2104" y1="405.9043" y2="405.9043"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="88.1626" x="855.7192" y="401.1621">result relation</text></g><g class="message" data-entity-1="part5" data-entity-2="part4" data-source-line="19" id="msg12"><polygon fill="#181818" points="651,431.2148,641,435.2148,651,439.2148,647,435.2148" style="stroke:#181818;stroke-width:1;"/><line style="stroke:#181818;stroke-width:1;stroke-dasharray:2,2;" x1="645" x2="837.7192" y1="435.2148" y2="435.2148"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="88.1626" x="657" y="430.4727">result relation</text></g><g class="message" data-entity-1="part4" data-entity-2="part1" data-source-line="20" id="msg13"><polygon fill="#181818" points="38.7524,460.5254,28.7524,464.5254,38.7524,468.5254,34.7524,464.5254" style="stroke:#181818;stroke-width:1;"/><line style="stroke:#181818;stroke-width:1;stroke-dasharray:2,2;" x1="32.7524" x2="639" y1="464.5254" y2="464.5254"/><text fill="#000000" font-family="sans-serif" font-size="13" lengthAdjust="spacing" textLength="135.6431" x="44.7524" y="459.7832">cursor over the result</text></g><?plantuml-src PP2zRiCm38HtFGMHfItGv04yT2ay5WWoTs5jDXRYI095ELkVlPHirp-TRDDtv7U7ZNY6zzwI4nEGnJOse1Cud56wK-_zBOK3O8JylL5yf5xibNqAct4TEheJOt-X7iLwbytrHd9cVsMyR-_HW7t2J9DSI_pff2C8e_8fWiCx5OvwC6RaXUDReO8AHav0uFcerRlmnUYQ3gAWa2bIjIpSQloshWKhPZLKILrMOWlF2rK6U8Ne4pVwx0XRwwulfYuK8wQwfhTJSRFtOkP_UUsW2WqTQTfZT7BS-6_AatVgS0fPBPaUZ27eLLXLi-eYKvDBkNoDkmEpRl0tWf-7bSwwQjlC3Z67BYIp_3ydKzJ6_j2M5HF7_lykKfCuQgT-82vXHlal?></g></svg>
\ No newline at end of file