Skip to content

Commit

Permalink
add readme
Browse files Browse the repository at this point in the history
  • Loading branch information
transcental committed Nov 22, 2024
1 parent b9ed261 commit 8316758
Showing 1 changed file with 28 additions and 0 deletions.
28 changes: 28 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
# Revolution's DNS

[![test](https://github.com/revolution-hacks/dns/workflows/test/badge.svg)](https://github.com/revolution-hacks/dns/actions?query=workflow%3Atest)
[![deploy](https://github.com/revolution-hacks/dns/workflows/deploy/badge.svg)](https://github.com/revolution-hacks/dns/actions?query=workflow%3Adeploy)

This repository is used for managing my DNS configuration through [OctoDNS](https://github.com/github/octodns). Please see its documentation for more information.

## Adding a subdomain

1. [Create a fork](https://docs.github.com/en/free-pro-team@latest/github/getting-started-with-github/fork-a-repo) of this repository.
2. In your fork open the [revohacks.com.yaml](./revohacks.com.yaml) file and add the following alphabetically based off the subdomain name:

```yaml
SUBDOMAIN_NAME:
- ttl: 600
type: CNAME
value: SOURCE_DOMAIN_OR_IP.
```
3. Replace `SUBDOMAIN_NAME` with the name of the sub-domain. So if the name was `hello` then the subdomain would be `hello.revohacks.com`.
4. Replace `SOURCE_DOMAIN_OR_IP` with the domain or IP address of the website you want the subdomain to go. If you are using an IP address change `type: CNAME` to `type: A`. Remember to leave that `.` at the end!
5. Commit your changes and [create the PR](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request-from-a-fork)!

That's it! Someone with contributor access to the repo will then review your PR.

If you're asked to make any changes to your pull request, please amend it by commiting to your fork, instead of closing it and creating another.

_Thanks to [hackclub/dns](https://github.com/hackclub/dns) for the idea and doing most of the work for me_

0 comments on commit 8316758

Please sign in to comment.