Expo Systems To-Do List

How this works

Click twice on a sub-heading to reveal the individual to-do items. Click again to hide.
If a heading is in italics, then there are hidden items.

Click on the main "How this works" heading to toggle reveal/hide everything.

Printing this page uses a much smaller font. Complain to the nerd list if you don't like this behaviour.

Edit this page by clicking on the big blue button. It uses the same "Edit this page" function that you may have used before. Just be careful not to touch the code at the top and bottom of the page.

We are working on a more capable and easier-to-use system which will mimic how GitHub Issues do this sort of thing.

To see the "data maintenance" and "survey data-entry" to-do lists, go to the other TO-DO list

Process Documentation

Wallets and new-cave

Explain (in the wallets process) how to view the surveys online so that
  (1) you can see an example of how to do your new one, and
  (2) so that you can check that you have done it properly when you have finished.

Explain how to link a new cave into the other caves in troggle filesystem

Explain how to add photos with the correct URL format to sub-HTML files attached to New Caves

svx check

explain command line to run on newly typed survex file to check for format errors '$cavern xxxx.svx'

explain when to use svxtrace.py current scripts

Making an svx - explain how to make link to *ref to wallet folder

explain how to put stuff in the wallet folder and how to look at expofiles/photos/xml/

Add to user data manual how to upload to expofiles - in the "survey manual"

Add in description of *where* to put the drawings files

QMs check

explain when to use svx2qm.py -> qms.csv-> tablize-qms.pl current scripts

explain when to use find-dead-qms.py and qmreader.pl current scripts

Handbook

Desperately needs Navigation - Location Context, Situational Awareness

No overall view of what there is: need a user-friendly diagrammatic overview sitemap. There are 4,869 files in :expoweb:

Not fixed by menus - breadcrumbs needed?

Diagrams of major sections: survey handbook, rigging handbook, computing handbook, Areas, cave data..

Chase Airoa to help fix the menus for phones

Look at gov.uk guidelines for inspiration

When git migration done

Edit out all mercurial

Split the TortoiseHg/PuTTy documentationa nd retain only PuTTy

NOEDIT flag

When editing multiple pages (using git), describe how this is implemented using <meta name="keywords" content="NOEDIT">

Editing Logbooks

DOCUMENT how to pout the "cave" or "locatoion" into the logbook entry title

add the triptitle "location - " to logbook template (example) file (where?)

Photos

Fix the BINS package

set up git on the BINS software? Fix base url sautret.org

set up a cron / Makefile job to run BINS

why is 'updatephotos' script in expofiles?

Document the ~expo/webphotos/ directory and how it works

Why does expofiles/photos/xml/ get created containing all the generated xml files? Fix this.

galley thumbs etc.

:expoweb:/galley/0.htm thumbnails not loading

Surveys data entry documentation

QMs check

3 ways to do it: archaic (as in databaseRest, new troggle & the Withnall script)

Write code to automatically extract ref info about wallets from tunnel xml files

This will replace :drawings:chk-xml.txt as used by :drawings:check-xml.sh

Do similar for Therion files when people start using #REF comments

2019 surveyscans

edit all the content.json

try to autocomplete the content.json by parsing .svx files

Put personal names into canonical form

2014 contents.json

parse all the svx files to extract people, dates & svx references

Laptop config.

imagemagick convert

Not working for PDFs on current version of xubuntu ! Fix & document. Also not working on WSL ubuntu. Needed to work with logbook images easily & to extract PDFs, JPEGs. Need to edit /etc/ImageMagick-6/policy.xml cromwell-intl.com/open-source/pdf-not-authorized.html

System Documentation

Document how we generate the SMK overall lengths and stats

scripts and manual actions in cavern

smklengths.sh script

smklengsths.odt

:loser:/docs/ files

Questions.txt

SMKlog.txt

"other scripts" - DOCUMENT

finish writing notes on files already identified

Troggle architecture

Handbook: add more to the new troggle architecture documentation. For future system maintainers

Regenerate the diagram of the tables in the database & document

Describe the parsing/import procedures so non-nerds can do it

Copy [some of] the .wiki material into the documentation somewhere

Surveyscans

explain where the image files are referenced from: svx, tunnel/therion, and

why there are so many broken links

non-troggle scripts

DOCUMENT them all - have we got a full list?

Troggle

Better import error messages

REPORT if import surveyscan file failure into database error log

REPORT 'folder not recognised' errors into error log inside database

WHY are total lengths of surveyed cave different between expo server and WSL server for 2019 and a few other years only ?

DEBUG - too many messages - reduce the number unless we need them

Why is "kataster' not found ?!

What is "GPS "not parsed in survex" mean

Test import when:

no profile logging .json file present

Troggle Menus

Explain how FLATPAGES work

NOEDIT flag Describe how this is implemented using <meta name="keywords" content="NOEDIT"> e.g. for auto-generated pages such as folk script

Logbook data model: unfilled fields?

'cave' of location field missing on nearly all logbook entries. Missing from logbook templates. Fill in manually for pre-2017 logbooks.

Expo Server

document directory structure

as per Julian's GitHub list - then close that issue

Makefile

Get it working !

permissions

do we need a cron job or has the group membership fix fixed it ? either way, document it.

Makefile - and permissions.

Apache & MySQL configuration

DOCUMENT How to set up a server

Fix and document permissions for cron jobs

Explain why Docker containers can be a maintenance nightmare

This to-do-list gadget itself

Status

Make it only click once to change display state of the DT tag

Eventual aim

to replace GitHub CUCCexposurveyissues for non-tunnel, non-GIS issues.

Try to automate simple functions in javascript

to control this document in-place (tick, delete) instead of using the tinymce HTML editor in Django

Maybe restructure whole page as JSON and use javascript editor to create (edit), re-order and demote items.

if using tinymcs, use the INLINE mode.

Implement comments on an issue, mimicking GitHub issues wiki

Use javascript to skip over the _edit page and submit changes direct to server when updating. Needs direct POST and include the javascript in the posted content.

checkboxes so that items can be ticked (which also does strike-through)

promotion/demotion options?

bin icon to delete an item? Better to have an archive process.

Local WSL server

Why is it using recuced-capability tinymce, a paths problem ?

Italics management

Put DL into italics when *any* DD is hidden