Make it more obvious which handbook pages are for whom/what.

This commit is contained in:
Wookey 2020-01-07 01:01:55 +00:00
parent f47e000235
commit 8702a51c8e
2 changed files with 18 additions and 7 deletions

View File

@ -8,7 +8,7 @@
<h2 id="tophead">CUCC Expedition Handbook</h2>
<h1>Cryptographic Key Exchange</h1>
<p>As of the server move in spring 2019 you need authorisation on the expo server to log in. This takes the form of an ssh key. You generate it on the machine you use for access, then send the public half to the server.</p>
<p>As of the server move in spring 2019 you need authorisation on the expo server to log in. This takes the form of an ssh key. You generate it on the machine you use for access, then send the public half to the server. Once done all logins are automatic - no passwords needed.</p>
<p>'ssh' is 'secure shell' and is widely used for secure access to machines and services.</p>
@ -38,6 +38,18 @@
<li>That will create a file: <tt>.ssh/id_rsa.pub</tt> in your home directory. Email that file to one of the admins listed above. </li>
</ol>
<h3>MacOS</h3>
<li>Erm, dunno...please fill in</li>
<h3>Android</h3>
<li>Erm, dunno...please fill in</li>
<h3>iOS</h3>
<li>Erm, dunno...please fill in</li>
<hr />
<div id="menu">

View File

@ -12,10 +12,10 @@
<h2><a id="manual">Expo data management programmers' manual</a></h2>
<ul>
<li>This page is <i>not</i> for cavers wanting to know how to record their cave survey data.
<li>This page is <i>not</i> for cavers wanting to know how to type in logbooks or upload photographs.
<li>This page is for cavers wanting to edit any expo data on their own machine. So that's the website, survey data, or drawn up surveys</li>
<li>This page is <i>not</i> for cavers wanting to know how to type in logbooks or upload photographs or edit data on the expo laptop.
<li>This page <i>is for programmers</i> who are helping cavers do their thing and <a href="#yourownlaptop">setting up their own laptop</a>.
<li>There is another page with more info on <a href="#yourownlaptop">the software expo uses and setting up your own laptop</a>.
</ul>
<p>Editing the expo data management system is an adventure. Learning
@ -69,10 +69,9 @@ Appendices:
</p>
<p>This password is all you need to log in to troggle and to use the troggle control panel (very few people need to do this). But if you want to update webpages (a much more common requirement) or to edit the software itself (very rare), then
you will also need to get a cryptographic key and register it with the server. See <a href="computing/keyexchange.html">key exchange</a> for details.
you will also need to get a login (register a key with the server). See <a href="computing/keyexchange.html">key exchange</a> for details.
<p>Unfortunately, pushing cave data to the ::loser:: and ::drawings:: repositories also needs a key. So cavers entering their cave survey data
currently have to use a machine on which this already set up. These machines are
<p>Pushing cave data to the ::loser:: and ::drawings:: repositories also needs a key. So cavers entering their cave survey data have to use a machine on which this already set up. These machines are
the <i>expo laptop</i> and the laptop '<i>aziraphale</i>' which live in the potato hut during expo. If you want to use your own laptop then
see <a href="#yourownlaptop">below</a>.