feat: expand project documentation

docs/workflow.qmd

@@ -100,7 +100,7 @@ flowchart TD
 
 - **Field Survey:** All items that are part of the [maxvogt collection](https://mtwente.github.io/maxvogt/) were visited in spring/summer 2024 for photo documentation and a survey of building features resp. spatial context. In a few cases where the address of a building was not provided in the sources, the locations could be determined via satellite imagery (e.g. the [service building in Landquart](https://mtwente.github.io/maxvogt/items/lq064.html)). Apart from taking photos, the authors collected information that was later put into the OpenStreetMap database.
 
-- **SBB Historic Archives*:** A lot of sources on Max Vogt's buildings are available in [SBB Historic's archive](https://www.sbbarchiv.ch/suchinfo.aspx). The catalogue was screened for content that was deemed to be relevant for the collection items. Some of SBB Historic content is also available on [Wikimedia Commons](https://commons.wikimedia.org/wiki/Category:SBB_Historic), but mostly the online catalogue points to offline data. Quite a lot of images are available to pre-view online, but it is not possible to download or embed them elsewhere. Noteworthy are the built heritage inventories done around the 1980s by Hans-Peter Bärtschi (e.g. an [inventorisation](https://www.sbbarchiv.ch/detail.aspx?ID=539243) of the station infrastructure in Feldbach SG).
+- **SBB Historic Archives:** A lot of sources on Max Vogt's buildings are available in [SBB Historic's archive](https://www.sbbarchiv.ch/suchinfo.aspx). The catalogue was screened for content that was deemed to be relevant for the collection items. Some of SBB Historic content is also available on [Wikimedia Commons](https://commons.wikimedia.org/wiki/Category:SBB_Historic), but mostly the online catalogue points to offline data. Quite a lot of images are available to pre-view online, but it is not possible to download or embed them elsewhere. Noteworthy are the built heritage inventories done around the 1980s by Hans-Peter Bärtschi (e.g. an [inventorisation](https://www.sbbarchiv.ch/detail.aspx?ID=539243) of the station infrastructure in Feldbach SG).
 
 - **External Web Content** was used in several cases for research and to add content to the online collection. Large repositories for potential data are YouTube – especially for historic amateur videos – and photo platforms. Apart from Flickr, more railway-specific platforms such as [bahnbilder.de](https://www.bahnbilder.de) come to mind, even though it turned out that most pictures found there focus on the rolling stock and not on the buildings. A few short news reports on Vogt and his buildings, most of them obituaries on the occasion of Vogt's death in 2019, can also be found online. Content of this type was mainly used to get more information on e.g. building heights or to determine at what point in time a building was renovated, painted, expanded etc. External web content was either directly added to the CollectionBuilder items or stored in the Zotero project bibliography (see below).
 
@@ -112,18 +112,23 @@ flowchart TD
 
 - **OpenStreetMap:** All relevant information gathered during the surveys was added to OpenStreetMap (OSM). All OSM data tagged as items by Max Vogt can be displayed via the Overpass API [using this query](https://osm.li/WV_). Except for two of Vogt's works, all were already present in the OSM database. Pre-existing data was enriched with more and up-to-date information from the suveys in spring/summer 2024. Several buildings had to be re-mapped by splitting up larger building complexes that had been mapped as one single item. Via the corresponding OSM tagging scheme, links [to Wikimedia Commons](https://wiki.openstreetmap.org/wiki/Key:wikimedia_commons) and [to Wikidata](https://wiki.openstreetmap.org/wiki/Key:wikidata) were added to the database (and vice versa). Additionally, all buildings were modelled according to the [Simple 3D Buidings tagging scheme](https://wiki.openstreetmap.org/wiki/Simple_3D_Buildings) and are, as of September 2024, available for use in OSM 3D renderers such as the [F4Map Demo](https://demo.f4map.com/#) or Kevin Nowaczyk's [OSM Building renderer](https://github.com/Beakerboy/OSMBuilding). Please note that not all renderers support all features of the Simple 3D Buildings tagging scheme.
 
+- **GitHub Repository *maxvogt*:** The GitHub repository at [*mtwente/maxvogt*](https://github.com/mtwente/maxvogt) is the technical basis for the online collection about Max Vogt set up by the authors. A detailed description is available in the repository's [readme](https://github.com/mtwente/maxvogt/blob/main/README.md). The repository contains an instance of [CollectionBuilder](https://collectionbuilder.github.io/), an open source framework for creating metadata-driven digital collections which is developed at the University Library of Idaho. Barely any actual research data is stored in the repository, since all collection items (images, PDFs, geodata) is fetched from other sources, such as Wikimedia Commons, SBB Archiv and others.
 
+- **GitHub Repository *maxvogt-analysis*:** The GitHub repository at [*mtwente/maxvogt-analysis](https://github.com/mtwente/maxvogt-analysis) is used for storing research data that was generated as part of this project. The authors provide project documentation, license information, instructions on how to reproduce the data set using Jupyter Notebooks. Geodata that is generated by running the notebooks is stored in the repository in json files, and is fetched from here to be displayed in the [online collection](https://mtwente.github.io/maxvogt) using a Leaflet map. The *maxvogt-analysis* repository is based on the [GitHub template for FAIR and open research data](https://maehr.github.io/open-research-data-template/) by [Moritz Mähr](https://www.moritzmaehr.ch), adhering to best practices for open research data as outlined by [The Turing Way](https://book.the-turing-way.org/index.html).
 
-- GitHub Repository *maxvogt*
-- GitHub Repository *maxvogt-analysis*
-- Zenodo
+- **Zenodo:** The authors use [Zenodo](https://zenodo.org/) for long-term archiving of the project data and its output, e.g. for making the project conference poster [available](https://doi.org/10.5281/zenodo.13837394) in PDF format.
 
 ### Output
 
-- Website *maxvogt*
-- Website *maxvogt-analysis*
-– Zotero
-- Conference Poster
+- **Website *maxvogt*:** One major part of the project is the online collection about Max Vogt's work. This collection is made with CollectionBuilder (see above), which generates a website for browsing the data set and facilitates explorative access to the collection using features such as timelines, maps and wordclouds. The website is hosted using [GitHub Pages](https://pages.github.com/) and is accessible via [https://mtwente.github.io/maxvogt](https://mtwente.github.io/maxvogt).
+
+- **Website *maxvogt-analysis*:** 
+
+. The website is hosted using [GitHub Pages](https://pages.github.com/) and is accessible via [https://mtwente.github.io/maxvogt](https://mtwente.github.io/maxvogt-analysis).
+
+– **Zotero:** The corpus of literature that was consulted for this research project consists of a few academic publications, especially from heritage conservation studies and Swiss architecture guides [e.g. @weidmann_max_2008-1; @noseda_vogt_1998; @allenspach_max_1994; @weidmann_max_2008]. Additionally, there are several articles in newspapers or in architecture journals relating to Vogt's work – either on the occasion of a station's redesign [e.g. @capol_funf_1998; @cieslik_elegant_2020; @hodel_infrastruktur_2019; @huber_schienenstrange_2022; @sbb_immobilien_revival_2023] or as part of obituaries for Vogt [e.g. @vogeli_max_2019; @salm_rohe_2019; @hohler_er_2019; @redaktion_zuriost_max_2019]. Relevant sources for contemporary descriptions of individual buildings are internal SBB documents such as employee newspapers [e.g. @generaldirektion_sbb_fortschritt_1979; @generaldirektion_sbb_grenzbahnhof_1978; @generaldirektion_sbb_neue_1979] and other corporate publications [e.g. @sbb_historic_kulturerbejahr_2018; @sbb_immobilien_revival_2023]. The latter category of documents is not accessible online. The authors used both [SBB Archives](https://www.sbbarchiv.ch/) or libraries such as the [Basel University Business and Economics Library/Swiss Economoic Archives](https://ub.unibas.ch/en/ubw-swa/). Sources were added to a [shared Zotero library](https://www.zotero.org/groups/5400359/sbb-max-vogt/library) to facilitate access to research on Max Vogt's work.
+
+- **Conference Poster:** See [SpatHum 2024 Poster](../docs/poster.qmd)
 
 
 ## Tools