From 0f0b0633a90c39519d8e8d44ced417880e3412dc Mon Sep 17 00:00:00 2001 From: Philip Sargent Date: Fri, 17 Mar 2023 14:34:07 +0000 Subject: [PATCH] Systematically clean QM grades documentation --- 1623/161/qmaven.htm | 7 ++--- 1623/161/qmdone.htm | 9 ++---- 1623/161/qmtodo.htm | 14 ++------- 1623/204/qm.html | 5 +-- 1623/234/qm.html | 4 ++- 1623/258/qm.html | 2 +- 1623/41/qmlist.htm | 10 +----- 1623/76/qmlist.htm | 3 ++ handbook/survey/qm.html | 61 +++++++++++++++++++++--------------- handbook/survey/qmentry.html | 8 +++-- 10 files changed, 59 insertions(+), 64 deletions(-) diff --git a/1623/161/qmaven.htm b/1623/161/qmaven.htm index db00c960a..ede67f78b 100644 --- a/1623/161/qmaven.htm +++ b/1623/161/qmaven.htm @@ -37,10 +37,9 @@ href="qmdone.htm">finished leads, which now have their own pages.

Format is Year of discovery, serial number, Quality Grade, Area indicator, decription of QM -

Quality Grades:

-
X
A high or unsafe-looking aven unlikely to be climbed -
?
No-one writing this list actually knows! -
+ +

Quality Grades: see documentation at QM conventions. + Area indicator:

BS
Big Sainsburys diff --git a/1623/161/qmdone.htm b/1623/161/qmdone.htm index 619ea3f08..409898c9c 100644 --- a/1623/161/qmdone.htm +++ b/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. -

Quality Grades:

-
A
A fine QM - git down there and look. -
B
Not so promising, or requiring some effort (eg. a climb) -
C
Pretty cruddy, or good but very hard to get to. -
X
A high or unsafe-looking aven unlikely to be climbed -
?
No-one writing this list actually knows! -
+

Quality Grades: see documentation at QM conventions. + Area indicator:

BS
Big Sainsburys diff --git a/1623/161/qmtodo.htm b/1623/161/qmtodo.htm index e7a387a72..bde8baa9c 100644 --- a/1623/161/qmtodo.htm +++ b/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 :-). -

Discoverer identifiers

-
B
Groupe Spéléeo de Clerval - Baume les Dames -
C
Cambridge University Caving Club -
-

Quality Grades:

-
A
A fine QM - git down there and look. -
B
Not so promising, or requiring some effort (eg. a climb) -
C
Pretty cruddy, or good but very hard to get to. -
V
An aven which might be climbable, but not adequately assessed -
X
A high, wet or unsafe-looking aven unlikely to be climbed -
?
No-one writing this list actually knows! -
+

Quality Grades: see documentation at QM conventions. +

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 diff --git a/1623/204/qm.html b/1623/204/qm.html index a9f83e044..be9b02003 100644 --- a/1623/204/qm.html +++ b/1623/204/qm.html @@ -16,9 +16,10 @@ -- 204 index

-

Conventions

+

QM Conventions

-

For question mark list conventions, see here.

+ +

Quality Grades: see documentation at QM conventions.

Area codes

diff --git a/1623/234/qm.html b/1623/234/qm.html index a284e39bd..901bd0349 100644 --- a/1623/234/qm.html +++ b/1623/234/qm.html @@ -18,7 +18,9 @@

Conventions

-

For question mark list conventions, see here.

+ +

Quality Grades etc.: see documentation at QM conventions. +

Area abbreviations

diff --git a/1623/258/qm.html b/1623/258/qm.html index 7db30bb64..24daaec03 100644 --- a/1623/258/qm.html +++ b/1623/258/qm.html @@ -19,7 +19,7 @@

Conventions

-

For question mark list conventions, see here.

+

Quality Grades: see documentation at QM conventions.

Question Marks

diff --git a/1623/41/qmlist.htm b/1623/41/qmlist.htm index ad4c56a9c..2c1c91442 100644 --- a/1623/41/qmlist.htm +++ b/1623/41/qmlist.htm @@ -15,15 +15,7 @@ found by CUCC are prefixed C<year>-41- under the system introduced in 1999.

Key:

-
    -
  • A very good, go for it.
    • -
  • B needs effort, or less promising
    • -
  • C hard to reach (bolting etc.), or very unpromising
    • -
  • ? quality unknown - poorly documented
    • -
  • ! may not exist, or may be multiple - guess from sketches
    • -
  • X has now been pushed - may be ref. into description.
    • -
  • * allegedly pushed, but needs another look or survey
    • -
+

Quality Grades: see documentation at QM conventions.

Probably seriously incomplete, especially for 1983-85.

diff --git a/1623/76/qmlist.htm b/1623/76/qmlist.htm index 46b5ce888..ed9a26ad0 100644 --- a/1623/76/qmlist.htm +++ b/1623/76/qmlist.htm @@ -12,6 +12,9 @@ 76 - main a bEislufthöhle5/S/E + + +

Quality Grades: see documentation at QM conventions. +

2004 QM List

diff --git a/handbook/survey/qm.html b/handbook/survey/qm.html
index 6e5ca0043..a760029bf 100644
--- a/handbook/survey/qm.html
+++ b/handbook/survey/qm.html
@@ -8,7 +8,7 @@
 
 
Question Mark list conventions

 
-
This page is somewhat outdated. For the current 21st century QM methods, 
+
For the current 21st century QM methods, 
 where we store QMs in the survex files, see
 

 
-
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. 
-
-
[Archaic: If
-you look at the html, you will find that the nearest survey station (without
-its "<cavenumber>." prefix) is included in an html comment for almost all
-leads.]

-
-
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 :-).

-
 
 
 
Quality grades

 
-
A - A fine QM - go down there and look.
-
B - Not so promising, or requiring some effort (eg. a climb).
-
C - Pretty cruddy, or good but very hard to get to.
-
D - A dig only possible to continue if loose rocks or soil are removed.
-
X - A high, wet or unsafe-looking aven unlikely to be climbed
+
A — A fine QM - go down there and look.
+
B — Not so promising, or requiring some effort (eg. a climb).
+
C — Pretty cruddy, or good but very hard to get to.
+
D — A dig only possible to continue if loose rocks or soil are removed.
+
X — A high, wet or unsafe-looking aven unlikely to be climbed
 
 


-
And we used to have (no longer used):
-
V - An aven which might be climbable, but not adequately assessed (use C or X instead, with comment)
-
? - Unknown - origin lost in history.
+
And we used to have (no longer used):

+V — An aven which might be climbable, but not adequately assessed (use C or X instead, with comment)

+? — Unknown - origin lost in history.

+! — may not exist, or may be multiple - guess from sketches

+* — allegedly pushed, but needs another look or survey

 
 
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" :-(

 
-
Discoverer identifiers

-
In past years, we used to add into the QM identifier an indication of who discovered it. This is no longer used.
+
QM identifier formats 

+
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.

+e.g. C1992-161-08 » the 8th QM in 1988 in cave 1623-161. Discovered by Expo: ("C")
+

+e.g. 234-2004-24B » the 24th QM in 2004 in cave 1623-234, grade B. 
+

+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 survexfile: 

+e.g. 290-2018-1Ccoconu3  » The 1st QM, grade C,  in survex-block 'coconutchamber3'
 which was surveyed in 2018 in cave 1623-290
+
+
Archaic: Last-century's notes about QMs in 161

+If you look at the html [the cave description page], you will find mentions,
+e.g. C1992-161-08 of QMs in the context of the passage description with a link to the 161 QM list page. A link to the nearest survey station (without
+its "<cavenumber>." prefix) is included in an html comment for almost all
+leads.

+
+
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 
+QM scripts], 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 :-).

+
+
+
Discoverer identifiers

+
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.
 
A - ARGE.
 
B - Groupe Spéléo de Clerval - Baume les Dames.
 
C - Cambridge University Caving Club - Expo.
diff --git a/handbook/survey/qmentry.html b/handbook/survey/qmentry.html
index 1fbaeee27..789ba2a78 100644
--- a/handbook/survey/qmentry.html
+++ b/handbook/survey/qmentry.html
@@ -14,7 +14,9 @@
 

 This document describes how to include Question Marks (QMs) and cave descriptions in .svx files. 
 
-
This is the current list of  QMs for 1623-290.
+
This is the current list of  QMs for 1623-290

+These are the current QM naming and numbering rules.
+
 
 
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.
 
;-----------
 ;Question Mark List  ;(leave commented-out)
-;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	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):

 ; 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 ]