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.
This commit is contained in:
Hugh Rundle 2021-01-31 21:20:34 +11:00
parent 7a2b83a97c
commit f37280f651
6 changed files with 28 additions and 11 deletions

3
.gitignore vendored
View file

@ -1,2 +1,3 @@
website/data/boundaries.geojson website/data/boundaries.geojson
website/secrets.js website/secrets.js
node_modules/*

View file

@ -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)*. 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 ## Licenses
**/website/data**: [CC-BY-SA](https://creativecommons.org/licenses/by-sa/4.0/) **/website/data**: [CC-BY-SA](https://creativecommons.org/licenses/by-sa/4.0/)

View file

@ -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. 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? ### Why this data?
@ -53,9 +56,3 @@ If this naming convention is confusing, you may view the map in *Colonial mode*,
* National & State Libraries * National & State Libraries
Standard Mode invites you to think about the work these institutions do to normalise certain types of knowledge and not others. 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).

View file

@ -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` 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 ### Visualisation
| Source | Link | License | | Source | Link | License |

View file

@ -29,8 +29,13 @@
<section class="info-page"> <section class="info-page">
<h2 id="about-library-map">About Library Map</h2> <h2 id="about-library-map">About Library Map</h2>
<p>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.</p> <p>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.</p>
<p>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).</p> <p>You should be able to find:</p>
<p>Soon you will be able to see which integrated library system (ILS/LMS) each library service uses.</p> <ul>
<li>the location of every public library in Australia territory, plus</li>
<li>the standard loan period for each libary service, and</li>
<li>whether they charge overdue fines, and</li>
<li>which integrated library system (ILS/LMS) each library service uses</li>
</ul>
<h3 id="why-this-data">Why this data?</h3> <h3 id="why-this-data">Why this data?</h3>
<p>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.</p> <p>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.</p>
<p>Rules about <strong>loan periods</strong> are arbitrary. I thought it might be interesting to see whether there are any regional trends. Im 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? 🤔</p> <p>Rules about <strong>loan periods</strong> are arbitrary. I thought it might be interesting to see whether there are any regional trends. Im 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? 🤔</p>

View file

@ -30,6 +30,12 @@
<h2 id="sources-attributions">Sources &amp; Attributions</h2> <h2 id="sources-attributions">Sources &amp; Attributions</h2>
<p><em>Library Map</em> was written and conceived on unceded Wurundjeri Woi Wurrung land.</p> <p><em>Library Map</em> was written and conceived on unceded Wurundjeri Woi Wurrung land.</p>
<p>If you believe I have breached a license in using your data, or attributed it incorrectly, please get in touch at <code>librarymap</code>@<code>hugh</code>.<code>run</code></p> <p>If you believe I have breached a license in using your data, or attributed it incorrectly, please get in touch at <code>librarymap</code>@<code>hugh</code>.<code>run</code></p>
<h3 id="contributors">Contributors</h3>
<p>These people have contributed to making the map:</p>
<ul id="contributors-list">
<li>Alissa M</li>
<li>Paul Schulz</li>
</ul>
<h3 id="visualisation">Visualisation</h3> <h3 id="visualisation">Visualisation</h3>
<table> <table>
<thead> <thead>