what this is
This commit is contained in:
parent
be3d77837e
commit
cd4b824b00
4 changed files with 132 additions and 6 deletions
50
docs/MAINTENANCE.md
Normal file
50
docs/MAINTENANCE.md
Normal file
|
|
@ -0,0 +1,50 @@
|
|||
# Maintenance guide
|
||||
|
||||
Use this guide when making regular content changes to the live static site.
|
||||
|
||||
## Safe change workflow
|
||||
|
||||
1. Start from an up-to-date `main`.
|
||||
2. Create a branch.
|
||||
3. Edit the smallest set of files needed.
|
||||
4. Start a local server from the repo root:
|
||||
|
||||
```bash
|
||||
python3 -m http.server 8000
|
||||
```
|
||||
|
||||
5. Preview each changed page at `http://localhost:8000/`.
|
||||
6. Check that images, internal links, and forms still behave as expected.
|
||||
7. Commit, push, and open a PR into `main`.
|
||||
|
||||
## What to edit first
|
||||
|
||||
For a maintained public website, prioritize these pages:
|
||||
|
||||
- `index.html`
|
||||
- `about-us/index.html`
|
||||
- `contact/index.html`
|
||||
- `events/index.html`
|
||||
- `services/index.html`
|
||||
- `videos/index.html`
|
||||
|
||||
These are the most visitor-facing pages. Archive pages can be improved later
|
||||
unless they contain broken links or outdated information that visitors rely on.
|
||||
|
||||
## What to avoid
|
||||
|
||||
- Do not rename public route folders without a redirect plan.
|
||||
- Do not edit `.forgejo/` for content or design changes.
|
||||
- Do not add build tools, package managers, or framework dependencies.
|
||||
- Do not delete WordPress-looking assets just because they look unused. Verify
|
||||
references first with `rg` and a browser preview.
|
||||
|
||||
## Suggested cleanup order
|
||||
|
||||
1. Confirm contact details, service times, and current event information.
|
||||
2. Check the core pages on desktop and mobile.
|
||||
3. Fix broken internal links and missing images.
|
||||
4. Remove or adjust forms that cannot submit on a static site.
|
||||
5. Clean duplicated WordPress metadata only after confirming pages render the same.
|
||||
6. Later, consider a tiny static templating workflow if shared navigation/footer
|
||||
edits become frequent.
|
||||
Loading…
Add table
Add a link
Reference in a new issue