diff --git a/README.md b/README.md index 05232f0..36e9ecd 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,31 @@ Home page for District Dharma based out of DC. -## todo +## Prerequisites -- focus highlighting on home page link -- email validation message? +1. **Heckin' Tech Gitea Personal Access Token (PAT)** + 1. Click on your user in the upper right and choose "Settings" from the dropdown + 1. Go to "Applications" in the left-hand settings menu + 1. Choose "Generate new token" + - Token name is up to you + - Token access should be public only + - Token permissions should be read & write on repositories + 1. **Save your token somewhere secure. If lost, you must generate a new token** +1. **Repository access:** Lee will grant contributor permissions. Repository URL is [heckin.technology/inherentlee/district-dharma](https://heckin.technology/inherentlee/district-dharma) + +## Managing content + +### Content management system + +Your content management system is Mattrbld. Mattrbld can be found at [mattrbld.com](mattrbld.com). The first time you access it (or access in a new browser, on a new machine, or with cookies wiped), you will need to give it the repository URL above and set up a user name. Feel free to just set your full name (spaces are ok). This will label your "commits" (changes) to the repository as you. + +### Making changes + +All changes will be in the "Pages" tab. There are two pages: + +- **attribution:** This page has a brief site creator attribution, mentions the site generator, credits the fonts used, and reports that no generative AI was used in creating the site. It is unlikely you will need to change this page. +- **index:** This page includes the body content for the home page of District Dharma. Note that it does *not* include the contact form at the bottom, which cannot be created via Mattrbld and is done on the backend. For form changes, contact Lee. + +### Saving changes + +To save your changes and see them reflected in the live site, you will navigate to the "Dashboard" tab and sync your changes. Here you will need to enter the email you use for the Heckin' Tech Gitea as well as the generated PAT. If you receive any non-transient errors, feel free to reach out to Lee.