Systematically clean QM grades documentation

1623/161/qmaven.htm

@@ -37,10 +37,9 @@ href="qmdone.htm">finished leads</a>, which now have their own pages.
 
 <p>Format is Year of discovery, serial number, Quality Grade, Area indicator, decription of QM
 
-<p>Quality Grades:<dl>
+
-<dt>X<dd>A high or unsafe-looking aven unlikely to be climbed
+<p>Quality Grades: see documentation at <a href="/handbook/survey/qm.html">QM conventions</a>.
-<dt>?<dd>No-one writing this list actually knows!
+
-</dl>
 
 Area indicator:<dl>
 <dt>BS<dd>Big Sainsburys

1623/161/qmdone.htm

@@ -39,13 +39,8 @@ have a link from the description of what it leads to. If the description of
 the QM is in one file, and what it led to is in another, then there will
 usually be both links.
 
-<p>Quality Grades:<dl>
+<p>Quality Grades: see documentation at <a href="/handbook/survey/qm.html">QM conventions</a>.
-<dt>A<dd>A fine QM - git down there and look.
+
-<dt>B<dd>Not so promising, or requiring some effort (eg. a climb)
-<dt>C<dd>Pretty cruddy, or good but very hard to get to.
-<dt>X<dd>A high or unsafe-looking aven unlikely to be climbed
-<dt>?<dd>No-one writing this list actually knows!
-</dl>
 
 Area indicator:<dl>
 <dt>BS<dd>Big Sainsburys

1623/161/qmtodo.htm

@@ -49,19 +49,9 @@ description to here, and a link from here to the relevant point in the
 description. If there is no link, it means that I can't yet work out where
 the QM is in the description, or the description doesn't yet exist :-).
 
-<p>Discoverer identifiers<dl>
-<dt>B<dd>Groupe Sp&eacute;l&eacute;eo de Clerval - Baume les Dames
-<dt>C<dd>Cambridge University Caving Club
-</dl>
 
-<p>Quality Grades:<dl>
+<p>Quality Grades: see documentation at <a href="/handbook/survey/qm.html">QM conventions</a>.
-<dt>A<dd>A fine QM - git down there and look.
+
-<dt>B<dd>Not so promising, or requiring some effort (eg. a climb)
-<dt>C<dd>Pretty cruddy, or good but very hard to get to.
-<dt>V<dd>An aven which might be climbable, but not adequately assessed
-<dt>X<dd>A high, wet or unsafe-looking aven unlikely to be climbed
-<dt>?<dd>No-one writing this list actually knows!
-</dl>
 
 <p>Note that the quality grades are assigned by the explorers at the time,
 and that subsequent discoveries may mean that the grade is optimistic, since

1623/204/qm.html

@@ -16,9 +16,10 @@
  -- <a href="204.html">204 index</a>
 </div>
 <hr />
-<h2>Conventions</h2>
+<h2>QM Conventions</h2>
 
-<p>For question mark list conventions, see <a href="../../qm.html">here</a>.</p>
+
+<p>Quality Grades: see documentation at <a href="/handbook/survey/qm.html">QM conventions</a>.
 
 <h2>Area codes</h2>
 

1623/234/qm.html

@@ -18,7 +18,9 @@
 <hr />
 <h2>Conventions</h2>
 
-<p>For question mark list conventions, see <a href="../../qm.html">here</a>.</p>
+
+<p>Quality Grades etc.: see documentation at <a href="/handbook/survey/qm.html">QM conventions</a>.
+
 
 <h2>Area abbreviations</h2>
 

1623/258/qm.html

@@ -19,7 +19,7 @@
 <hr />
 <h2>Conventions</h2>
 
-<p>For question mark list conventions, see <a href="/handbook/survey/qm.htm">here</a>.</p>
+<p>Quality Grades: see documentation at <a href="/handbook/survey/qm.html">QM conventions</a>.
 
 <h2>Question Marks</h2>
 

1623/41/qmlist.htm

@@ -15,15 +15,7 @@ found by CUCC are prefixed C<year>-41- under the system introduced
 in 1999.</p>
 
 <p>Key:</p>
-<ul>
+<p>Quality Grades: see documentation at <a href="/handbook/survey/qm.html">QM conventions</a>.
-<li> <b>A</b> very good, go for it.</li>
-<li> <b>B</b> needs effort, or less promising</li>
-<li> <b>C</b> hard to reach (bolting etc.), or very unpromising</li>
-<li> <b>?</b> quality unknown - poorly documented</li>
-<li> <b>!</b> may not exist, or may be multiple - guess from sketches</li>
-<li> <b>X</b> has now been pushed - may be ref. into description.</li>
-<li> <b>*</b> allegedly pushed, but needs another look or survey</li>
-</ul>
 
 <p>Probably seriously incomplete, especially for 1983-85.</p>
 

1623/76/qmlist.htm

@@ -12,6 +12,9 @@
 <tr><th id="kat_no">76 - main a b</th><th id="name">Eislufth&ouml;hle</th><th id="status">5/S/E +</th></tr>
 </table>
 
+
+<p>Quality Grades: see documentation at <a href="/handbook/survey/qm.html">QM conventions</a>.
+
 <H1>2004 QM List</H1>
 
 <pre>

handbook/survey/qm.html

@@ -8,7 +8,7 @@
 <body>
 <h1>Question Mark list conventions</h1>
 
-<p>This page is somewhat outdated. For the current 21st century QM methods, 
+<p>For the current 21st century QM methods, 
 where we store QMs in the survex files, see
 <ul>
 <li><a href="qmentry.html">QM data and cave descriptions</a>
@@ -16,34 +16,22 @@ where we store QMs in the survex files, see
 <li>Only if really keen: <a href="../troggle/scriptsqms.html">QMs - the fourfold path</a>
 </ul>
 
-<p>The format for question mark lists is QM identifier, Quality Grade, Area
-indicator, decription of QM. The QM numbers themselves are in the format
-Discoverer identifier, Year of discovery, Cave identifier, serial number. 
-
-<p>[Archaic: If
-you look at the html, you will find that the nearest survey station (without
-its "&lt;cavenumber&gt;." prefix) is included in an html comment for almost all
-leads.]</p>
-
-<p>In general, an unpushed QM will have a link from its QM number in the
-cave description file to the HTML QM list file (generated by a perl script for caves 204, 234 and 258), and a link from the list to the relevant point in the
-description. If there is no link, it means that we can't yet work out where the
-QM is in the description, or the description doesn't yet exist :-).</p>
-
 
 
 <h2>Quality grades</h2>
 
-<p><b>A</b> - A fine QM - go down there and look.
+<p><b>A</b> &mdash; A fine QM - go down there and look.
-<p><b>B</b> - Not so promising, or requiring some effort (eg. a climb).
+<p><b>B</b> &mdash; Not so promising, or requiring some effort (eg. a climb).
-<p><b>C</b> - Pretty cruddy, or good but very hard to get to.
+<p><b>C</b> &mdash; Pretty cruddy, or good but very hard to get to.
-<p><b>D</b> - A dig only possible to continue if loose rocks or soil are removed.
+<p><b>D</b> &mdash; A dig only possible to continue if loose rocks or soil are removed.
-<p><b>X</b> - A high, wet or unsafe-looking aven unlikely to be climbed
+<p><b>X</b> &mdash; A high, wet or unsafe-looking aven unlikely to be climbed
 
 <br /><br />
-<p>And we used to have (no longer used):
+<p>And we used to have (no longer used):<br />
-<p><b>V</b> - An aven which might be climbable, but not adequately assessed (use C or X instead, with comment)
+<b>V</b> &mdash; An aven which might be climbable, but not adequately assessed (use C or X instead, with comment)<br />
-<p><b>?</b> - Unknown - origin lost in history.
+<b>?</b> &mdash; Unknown - origin lost in history.<br />
+<b>!</b> &mdash; may not exist, or may be multiple - guess from sketches<br />
+<b>*</b> &mdash; allegedly pushed, but needs another look or survey<br />
 
 <p>Note that the quality grades are assigned by the explorers at the time, and 
 that subsequent discoveries may mean that the grade is optimistic, since the 
@@ -51,8 +39,31 @@ lead may now drop into passage which wasn't then explored. Also, different
 explorers have different ideas, or different waist sizes - one man's "A-lead"
 may be another's "C-lead" :-(</p>
 
-<h2>Discoverer identifiers</h2>
+<h3>QM identifier formats </h3>
-<p>In past years, we used to add into the QM identifier an indication of who discovered it. This is no longer used.
+<p>The format for question mark identifiers has changed over the years. We used to renumber all the QMs after expo, so a simple 200x-QMnn was unique. At some point, before 2015 when we started putting the QMs in survex files, the QM numbering was done per-cave rather than per-Expo.<br/>
+e.g. <b>C1992-161-08</b> &raquo; the 8th QM in 1988 in cave 1623-161. Discovered by Expo: ("C")
+<br/>
+e.g. <b>234-2004-24B</b> &raquo; the 24th QM in 2004 in cave 1623-234, grade B. 
+<p>
+Currently we use the survex block name, the name of the *begin/*end section, as the thing to make QMs unique. We also show the year, the cave and the grade in all visible identifiers though these are not required for uniqueness.
+A separate sequence of identifier numbers is used for each survex<em>file</em>: <br/>
+e.g. <b>290-2018-1Ccoconu3</b>  &raquo; The 1st QM, grade C,  in survex-block 'coconutchamber3'<br/> which was surveyed in 2018 in cave 1623-290
+
+<h4>Archaic: Last-century's notes about QMs in 161</h4>
+If you look at <a href="/1623/161/lhr.htm">the html</a> [the cave description page], you will find mentions,
+e.g. <a href="/1623/161/lhr.htm#qC1992-161-08">C1992-161-08</a> of QMs in the context of the passage description with a link to <a href="/1623/161/qmtodo.htm#C1992-161-08">the 161 QM list page</a>. A link to the nearest survey station (without
+its "&lt;cavenumber&gt;." prefix) is included in an html comment for almost all
+leads.</p>
+
+<p>In general, an unpushed QM will have a link from its QM number in the
+cave description file to the HTML QM list file (generated by a perl script for caves 204, 234 and 258) [see 
+<a href="../troggle/scriptsqms.html">QM scripts</a>], and a link from the list to the relevant point in the
+description. If there is no link, it means that we can't yet work out where the
+QM is in the description, or the description doesn't yet exist :-).</p>
+
+
+<h3>Discoverer identifiers</h3>
+<p>In past years, we used to put a prefix on the QM identifier as an indication of who discovered it. This is no longer used.
 <p><b>A</b> - ARGE.
 <p><b>B</b> - Groupe Sp&eacute;l&eacute;o de Clerval - Baume les Dames.
 <p><b>C</b> - Cambridge University Caving Club - Expo.

handbook/survey/qmentry.html

@@ -14,7 +14,9 @@
 <p>
 This document describes how to include Question Marks (QMs) and cave descriptions in .svx files. 
 
-<p>This is the current list of  <a href="/cave/qms/1623-290">QMs for 1623-290</a>.
+<p>This is the current list of  <a href="/cave/qms/1623-290">QMs for 1623-290</a><br />
+These are the current <a href="qm.html">QM naming and numbering rules</a>.
+
 
 <p>There
 are dedicated fields in the template.svx file for this purpose, but there has been laxness recently on filling them in.
@@ -63,7 +65,7 @@ just fine that these are QMs.
 Here is an example from the last bit of bipedalpassage.svx in 264. Note that each QM description is all on one line.
 <pre><code>;-----------
 ;Question Mark List  ;(leave commented-out)
-<em>;Serial number   grade(A/B/C/D/V/X)  nearest-station  resolution-station  description</em>
+<em>;Serial number   grade(A/B/C/D/X)  nearest-station  resolution-station  description</em>
 ;QM1  A	bipedalpassage.1	-	Very good. 50m+ (?) deep pit below start of 13 bolt bipedal traverse - rather slanted, large ongoing rift glimpsed below. very good.
 ;QM2  A	bipedalpassage.3	-	Very good. 50m+ (?) deep pit below end of 13 bolt bipedal traverse. best approched via station 4 (?) and looks ok to rig. May connect to first deep pit.
 ;QM3  C	bipedalpassage.1	-	Poor c lead, across thin rock bridge over abyss (!) leads to blind aven, but small tube for thin person on left.
@@ -122,7 +124,7 @@ real content replaces template text):</p>
 ; QM doesn't go anywhere, set the resolution-station to be the same as the
 ; nearest-station. Include any relevant details of how to find or push the QM in
 ; the textual description.
-;Serial number   grade(A/B/C/D/V/X)  nearest-station  resolution-station description
+;Serial number   grade(A/B/C/D/X)  nearest-station  resolution-station description
 ;[ QM1    A    surveyname.3    -    description of QM ]
 ;[ QM2    B    surveyname.5    -    description of QM ]