1. Introduction¶
This project runs on Sandpoints, a module/theme for the static website builder www⁄Hugo. Sandpoints is developed for free, open, and collaborative publishing using open-source infrastructure. Content is organized with plain-text Markdown files, and collaboration/version control is managed via www⁄Git. Thus, with the infrastructure in place, no programming is needed.
However, for managing and maintaining the site in a sustainable manner, as well as for processing/publishing submissions, some knowledge is required pertaining to how this infrastructure works and how it can be maintained; how to work with article⁄Markdown files; how to manage distributed collaboration via a version control system; and to adhere to agreed upon conventions.
This is an internal ‘issue’ (supposed to remain non-public, intended as a ’living document’), which contains the following ‘articles’:
- article⁄Understanding Sandpoints, gives an overview of the philosophy and features of Sandpoints.
- article⁄Site management contains instruction and guides for maintainers of the site.
- article⁄Conventions is intended for gathering conventions we should go by.
- article⁄Library management, contains a guide for the library maintainers and contributors.
- article⁄Feature requests and issues, is intended for listing potential required features, and for filing issues.