public_library_map/about.md
Hugh Rundle 883195cf83 update docs and merge file
- add instructions for updating CSV and not JSON
- fix filepaths in merge_service_data.py
- add info about license agreement for contributors
- explain about large files that are currently missing

Fixes #7
Fixes #15
2021-01-23 19:43:03 +11:00

66 lines
5.4 KiB
Markdown

## About Library Map
This project collects and maps data from public libraries across the Australia and the external Australian Territories of Christmas Island and the Cocos (Keeling) Islands. In the long term I hope to include more data that can be combined and cross-referenced, e.g. library funding from local and state governments, HILDA data etc.
You should be able to find the location of every public library in Australia territory, plus the standard loan period for each libary service, and whether they charge overdue fines (if known, in both cases).
Soon you will be able to see which integrated library system (ILS/LMS) each library service uses.
### Why this data?
When I worked as a systems librarian in public libraries I often wondered how the social networks of decision makers - most obviously reflected by geography and state borders - affected decision making on things like library sofware procurement. I thought mapping systems visually might reveal things that are less obvious on a simple table or list.
Rules about **loan periods** are arbitrary. I thought it might be interesting to see whether there are any regional trends. I'm surprised by some of the results — do some libraries really have a standard loan period of six weeks? Seems kind of long. Why do so many rural libraries only lend items for two weeks? Is it because country people read faster, or something to do with limited book stock? 🤔
**Fines for overdue library books** are inefficient, ineffective, perverse, and regressive. "Punishable by fine" simply means "legal for rich people". Mapping library fine regimes provides a view of any regional patterns, helps library managers to identify nearby colleagues who have already made their library fine-free and may be able to provide advice, and also allows activists to identify which libraries and local councils would benefit from some encouragement.
### Definitions
#### Overdue fines
A library service is classified as charging fines for overdue items if any kind of non-refundable fee is charged prior to **28 days overdue**. This period has been chosen because some libraries declare an item "lost" around that time, and invoice the borrower for a *replacement fee*. Designating these libraries as "not charging overdue fines" and others that charge e.g. a "notice fee" at the same cutoff time as "charging overdue fines" starts to get a bit weird.
#### Fines for children
Some libraries charge fines or fees for late-returned items, but exempt members who are under the age of (variously) 12, 16, 17, or 18; and/or for items designated as "for children". Rather than creating my own specific definition I classify all libraries with a fine regime like this as "no fines for children". Wouldn't it be better if they just didn't charge overdue fines at all?
#### Standard loan period
The "standard loan period" is the loan period applied to an ordinary book, and may apply to other items or indeed all items held in a library. Data for Western Australia is provisional and in some cases has been rounded to the nearest "week" (e.g. a 19 day loan period is recorded as 3 weeks).
#### Indigenous Knowledge Centre
Currently, only libraries classified as *Indigenous Knowledge Centres* by the State Library of Queensland are classified as such on this map. In future there may be other centres so identified.
### Caveats
Most of the data for the map comes from government open data sources. As such it is subject to government bias, and may be out of date or over/under sampled. I make no claim or warranty that the data being complete, accurate, or up to date — though I aim for it to be all of those things. If in doubt, always check with the library directly.
### Nomenclature
Library locations are classified into four types. In general mode these are:
* Settler Knowledge Centres
* Indigenous Knowledge Centres
* Worker Pacification Centres
* Imperial Knowledge Centres
If this naming convention makes you uncomfortable, you may view the map in *White fragility mode*, in which case the names are:
* Public Libraries
* Indigenous Knowledge Centres
* Mechanics Institutes
* National & State Libraries
### Important files that are not in this repository
If you look at `merge_service_data.py` you will notice that there are two files used in creating `website/data/boundaries.topo.json` that are missing from this repository:
* website/data/boundaries.geojson
* website/data/all_library_services.geojson
The first is the "core" geojson file with boundaries for each library service. The only other data it holds is the name of each area. The second is the file created when we run `merge_service_data.py` to merge data from `website/data/library_services_information.csv` into `website/data/boundaries.topo.json`.
These files aren't included in the GitHub repo for the simple reason that Git has a 100MB limit, and both files are larger than that.
If you want to update library service data (e.g. to add missing data about the standard loan period for a particular library service) then **you should edit `website/data/library_services_information.csv`** — *not* `website/data/boundaries.topo.json`. After I merge your PR I will then pull down the updated file, run the merge script, and update the topoJSON file. It would be better to automate this and I can probably rewrite the script to update the TopoJSON directly, but currently that's the workflow, and it will *always* be that contributors should update the CSV file, not the JSON.