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 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'
Downgrade the "areas" aspect of the documentation as we don't use these now
Add links to these resurrected area guides from relevant other parts of the handbook
Prospecting Guides & slippy map & GPS tracks
This whole subsystem needs a good examination and possible rewriting. :expoweb:/noinfo/prospecting_guide_scripts
Photos
Fix the BINS package (Wookey is looking for replacement)
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
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
Troggle architecture
Handbook: add package diagram totroggle 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
Be exhaustive in checking all the broken links between svx & wallets
non-troggle scripts
DOCUMENT them all - have we got ? //expofiles/unidentified_scripts/ !
Makefile
Get it working ! How many of other scripts should be in it ? Should we do data imports to schedule too ?
Troggle
Better import error messages
REPORT if import surveyscan file failure into database error log -> "DataIssue" register
REPORT 'folder not recognised' errors into error log inside database -> "DataIssue" register
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
FIND where that default cave print __unicode__() is happening
Missing .3d files
REPORT if there is no .3d file - make it if it is not there ? O rjust leave it to Makefile ?
Troggle parser/viewer
Explain how FLATPAGES work. refer to computing/hbmanual1.html
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.
Use 'tee' to cretae ascii art for this.
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
Document "anacron" / cron system on server
Explain why Docker containers can be a maintenance nightmare
/expofiles/ needs config , refer to apache/django docm.
/static/ needs config - refer to django docm.
This to-do-list gadget itself
Status
Make it only click once to change display state of the DT tag
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 ?