Thank you for your interest in contributing to this project!
Great!
Big-picture there are two things you need to do:
- Add the webring code to your website, and
- Add yourself to the webring's
data/members/
directory as JSON file as a pull request.
This step ensures that the webring will not have a dead end when you join it.
Copy the webring code and put it somewhere on your website.
This process depends on how your website is built, so unfortunately I cannot provide much support for this step.
To add yourself to the webring, submit a pull request to this repository where you have added your information as a JSON file. You can reference and copy/paste my JSON entry as a format to use.
date
: The day you add yourself to the webring, inYYYY-MM-DDThh:mm
format. You can useT00:00
for the hour an minute if you want.name
: Your name (can be your given name, a nickname, a handle, etc.).url
: Your website's address (ex:https://web-a11y.club/
). The URL must use the HTTPS protocol.
Ideally, your url
points to the page that displays the webring code, but this is not required.
accessibilityStatement
: The URL for your website's accessibility statement.github
: Your GitHub profile address (ex:https://github.com/yourname
).linkedin
: Your LinkedIn profile address (ex:https://www.linkedin.com/in/yourname/
).bluesky
: Your Bluesky account (ex:https://bsky.app/profile/@YourName.bsky.social
).mastodon
: Your Mastodon account (ex:https://mastodon.social/@YourName
).rss
: The RSS feed for your website.
If you do not have this information, please use null
for the entry's value:
"mastodon": null
Be sure to save your webring member JSON file using the same name as your name
value. For example, mine is called Eric Bailey.json
.
Once your pull request is merged, the webring's list of members will automatically update to list the information you provided ✨
Once these two steps are completed, both the webring and your site will allow for discovery!
This process is similar to adding yourself to the webring.
Submit a pull request that modifies your JSON member information. This can include:
- Adding info,
- Updating info, and
- Removing info.
Want to help out? Cool!
Please check the project Issues to see if there is something I'm specifically looking for help with.
If you want to propose new features or functionality, please create an issue before submitting a pull request. This will help us determine if your suggestion is inline with my vision for where the project should go.
Unfortunately, this is something that will break the webring. Since you do not own your content on these platforms they are incompatible with a webring's approach. This is why some of these services are offered as optional links you can add.
I'm definitely open to suggestions! I will not allow Twitter/X or Threads, due to ethical issues I have with each platform.
If you have a suggestion for a service other than those two, please create an issue so we can chat it out.
That's a nice idea, but I prefer if the person who made the site adds themselves for a variety of reasons. You could definitely suggest they do so, though!
That's fine, too. If you choose leave the webring I ask that:
- You either submit a PR removing your membership JSON file, or raise an issue asking to be removed, and
- You delete the webring code from your website.
This will remove you from the webring and also allow people browsing the webring to not get stuck.
Welcome back! All you need to do is follow the steps to add your site to the webring again.
Nice! Check out this webring project made by Max Böck.
This code is the starting point I used to make this project. It relies on Netlify to work.
Send me an email or a DM on Mastodon and we'll get things sorted.