From f37280f651aaecb2a4e3a2630d279900a38fc2d4 Mon Sep 17 00:00:00 2001 From: Hugh Rundle Date: Sun, 31 Jan 2021 21:20:34 +1100 Subject: [PATCH] update docs & website In preparation for new Action to add contributors on each push, this updates various pages in the docs and the website. Also updates .gitignore to ignore node_modules Also updates to website to account for the geojson file now being in the repository. --- .gitignore | 3 ++- README.md | 4 ++++ about.md | 13 +++++-------- sources.md | 4 ++++ website/about/index.html | 9 +++++++-- website/sources/index.html | 6 ++++++ 6 files changed, 28 insertions(+), 11 deletions(-) diff --git a/.gitignore b/.gitignore index 7a2b6a0..aeea2ba 100644 --- a/.gitignore +++ b/.gitignore @@ -1,2 +1,3 @@ website/data/boundaries.geojson -website/secrets.js \ No newline at end of file +website/secrets.js +node_modules/* \ No newline at end of file diff --git a/README.md b/README.md index 7b6e91f..0483fe0 100644 --- a/README.md +++ b/README.md @@ -16,6 +16,10 @@ See [sources](sources.md). See [contributing](contributing.md), especially *[which files to update](https://github.com/hughrun/public_library_map/blob/master/contributing.md#which-files-to-update)*. +## Contributors + +Contributors (whether via GitHub or another way) are listed at [contributors.txt](contributors.txt). + ## Licenses **/website/data**: [CC-BY-SA](https://creativecommons.org/licenses/by-sa/4.0/) diff --git a/about.md b/about.md index e629f88..6b95a59 100644 --- a/about.md +++ b/about.md @@ -2,9 +2,12 @@ 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). +You should be able to find: -Soon you will be able to see which integrated library system (ILS/LMS) each library service uses. +* the location of every public library in Australia territory, plus +* the standard loan period for each libary service, and +* whether they charge overdue fines, and +* which integrated library system (ILS/LMS) each library service uses ### Why this data? @@ -53,9 +56,3 @@ If this naming convention is confusing, you may view the map in *Colonial mode*, * National & State Libraries Standard Mode invites you to think about the work these institutions do to normalise certain types of knowledge and not others. - -### Important file that is not in this repository - -The "core" geojson file with boundaries for each library service is not in the repository. The only other data it holds is the name of each area. When boundaries need to be changed for some reason (a regional library service de-merges, for example), this file needs to be updated using GQIS, and then processed into TopoJSON using `geo2topo`. - -This file isn't included in the GitHub repo for the simple reason that Git has a 100MB limit, and the file is larger than that. I could use Git-LFS but GitHub charges for moving large files around, and updating this file will rarely be necessary. If you want to access the geojson file you can find it at [librarymap.hugh.run/data/boundaries.geojson](https://librarymap.hugh.run/data/boundaries.geojson) \[105MB]. Contributors to this file are noted in [sources](sources.md). diff --git a/sources.md b/sources.md index 519c45d..4562bab 100644 --- a/sources.md +++ b/sources.md @@ -4,6 +4,10 @@ If you believe I have breached a license in using your data, or attributed it incorrectly, please get in touch at `librarymap`@`hugh`.`run` +### Contributors + +See [contributors](contributors.txt). + ### Visualisation | Source | Link | License | diff --git a/website/about/index.html b/website/about/index.html index 01e5273..fb1f2e4 100644 --- a/website/about/index.html +++ b/website/about/index.html @@ -29,8 +29,13 @@

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.

+

You should be able to find:

+

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? 🤔

diff --git a/website/sources/index.html b/website/sources/index.html index 575561e..6e6211f 100644 --- a/website/sources/index.html +++ b/website/sources/index.html @@ -30,6 +30,12 @@

Sources & Attributions

Library Map was written and conceived on unceded Wurundjeri Woi Wurrung land.

If you believe I have breached a license in using your data, or attributed it incorrectly, please get in touch at librarymap@hugh.run

+

Contributors

+

These people have contributed to making the map:

+

Visualisation