microcosm.blue
top secret
contributing
bad-example.com
+24
+24
contributing.md
+24
contributing.md
···
1
+
# Contributing to the hubble website
2
+
3
+
If you think the website needs a new feature, [open an issue on tangled](https://tangled.org/microcosm.blue/hubble-website/issues/new) so we can discuss!
4
+
5
+
This is a static site, built with astro. For now everythign should be able to compile down to static HTML. Hubble will eventually need a limited set of dynamic features, which will probably live directly on this website, maybe on just one page. (That can probably be a tiny web app with an atproto public OAuth client (the two-week expiration is fine), but it's possible we'll need a backend for some reason).
6
+
7
+
8
+
## Dependencies
9
+
10
+
Adding build-time dependencies are fine where needed. Don't add assets that load from public CDNs.
11
+
12
+
13
+
## Accessibility
14
+
15
+
Make sure text is legible, with enough contrast, in both light and dark modes.
16
+
17
+
Interactive elements should lean on simple web features where possible.
18
+
19
+
20
+
## Internationalization
21
+
22
+
The website should be available in multiple languages eventually, but this isn't implemented yet. For now, just avoid doing anything too tricky with english text manipulation in the code that might make translations difficult later.
23
+
24
+
It might be nice to set up the i18n framework up even before any actual translation work can start.