jgdr/content/issue/int-issue-management.md

31 lines
No EOL
2 KiB
Markdown

---
title: "Project management (this will be internal) ☸"
date: "2023-06-24T16:05:06+03:00"
author: "anybody"
draft: false
has_articles: ["int-sandpoints.md","int-management.md","int-library.md","int-conventions.md",int-break.md", "int-features.md","int-todo.md"]
keywords:
- internal
abstract: |
(Internal) 'Issue' type page, containing 'articles' related to managing and maintaining this project.
---
[Git]: https://git-scm.com/ "Git is a free and open-source distributed version control system."
[Hugo]: https://gohugo.io/ "Free and open-source static website builder."
# Introduction
This project runs on *Sandpoints*, a module/theme for the static website builder [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 [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 ![Markdown files](article:md-formatting); 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':
1. ![Understanding Sandpoints](article:int-sandpoints), gives an overview of the philosophy and features of *Sandpoints*.
2. ![Site management](article:int-management) contains instruction and guides for maintainers of the site.
4. ![Conventions](article:int-conventions) is intended for gathering conventions we should go by.
5. ![Library management](article:int-library), contains a guide for the library maintainers and contributors.
6. ![Feature requests and issues](article:int-features), is intended for listing potential required features, and for filing issues.