Merge pull request #84 from is-a-dev/services

feat: remove description and repo fields from domain structure

Author: wdhdev

src/guides/vercel.md

@@ -12,17 +12,12 @@ This guide will walk you through the process of setting up a Vercel site and poi
 
 If you haven't made a Vercel site, make sure to make one. Follow the instructions in [Vercel's Docs](https://vercel.com/docs/getting-started-with-vercel).
 
-### Creating the domain files
+### Creating the domain
 
-First, go to your Vercel dashboard, then go to your project, then go to Custom Domains and enter the is-a.dev subdomain you want.
-
-**You will need to make two files to ensure this process goes smoothly**. We will go in order for this section.
-
-1. Make a file for Vercel TXT verification.
-   When connecting the domain, you will be greeted with a TXT verification string. To make the file for this one the TXT record should be placed in `_vercel.subdomain.json` in the **domains directory** (replace subdomain with the domain you want of course) and the file should be like this:
-!!!
-You can also replace the email with any form of social media handle (Like Discord, Twitter, Bluesky, Mastodon etc.).
-!!!
+1. Navigate to your Vercel dashboard. Then, navigate to the "Domains" tab of your project's settings. Click "Add Domain" and enter the is-a.dev subdomain you want (e.g. `example.is-a.dev`). 
+2. Once you're past the "Configure Environment and Redirects" tab—if unsure, just click "Save"—then click "Continue manually". Copy the TXT verification value that you'll get; you'll need this in step 4.
+3. Fork our [repository](https://github.com/is-a-dev/register) and create a file **in the `/domains` folder** named `your-domain.json`. Replace `your-domain` with the name of the subdomain you chose earlier in the Vercel dashboard.
+4. In this file, paste the following JSON and ***make sure to replace all the values properly***, except for the CNAME, which you should leave untouched.
 
 ```json
 {
@@ -31,50 +26,17 @@ You can also replace the email with any form of social media handle (Like Discor
         "email": "[email protected]"
     },
     "records": {
-        "TXT": "insert-TXT-string-you-got-from-vercel-here"
-    }
-}
-```
-
-!!!
-**_DON'T MAKE A PULL REQUEST YET_**, we still have to make another file. If you were to make a pull request at this point, we would reject your domain since you are trying to make a nested subdomain on a subdomain you don't own yet. Please proceed to the next step.
-!!!
-
-2. Create a file for the main domain.
-   Now you need to make a file for the main domain, we have two ways to do it: CNAME and A records. We'll have two different files for these and explain what restricions or stuff you need to do.
-
-Create `subdomain.json` in the **domains directory** (replace subdomain with the domain you want of course) and put in the file one of these types:
-
-**CNAME record**: If you are using CNAME record you don't have to give a preview as you are using the site as the CNAME, but you can't use other record (Like MX and TXT records) unless the domain is proxied. For information on how to proxy a domain, see [proxying your domain](https://docs.is-a.dev/domain-structure/#proxied-optional).
-
-```json
-{
-    "owner": {
-        "username": "your-github-username",
-        "email": "[email protected]"
+        "CNAME": "cname.vercel-dns.com"
     },
-    "records": {
-        "CNAME": "domainname.vercel.app"
+    "services": {
+        "vercel": "insert-TXT-string-you-got-from-vercel-here"
     }
 }
 ```
 
-**A record**: If you are using an A record, you would need to give a preview either by putting a link in the comment section of the PR, putting it in the description, or by providing a screenshot of your website. **This option is ideal for those who want to use their domain for their site and email**.
-
-```json
-{
-    "owner": {
-        "username": "your-github-username",
-        "email": "[email protected]"
-    },
-    "records": {
-        "A": ["76.76.21.21"]
-    }
-}
-```
 
 ### Make a pull request
 
-Once you have made these two files, you can now make a pull request to the [main repo](https://github.com/is-a-dev/register). Then you'll have to be patient until it gets merged. If you want a chance to get your PR merged faster then join our [Discord server!](https://discord.gg/is-a-dev-830872854677422150).
+Once you have created your file, make a pull request to the [main repository](https://github.com/is-a-dev/register). Then you'll need to be patient until it gets merged. If you want a chance to get your PR merged faster, join our [Discord server](https://discord.gg/is-a-dev-830872854677422150) and send your pull request link ***once*** in `#pull-requests`.
 
-When the pull request has been merged your site should be working; if it is still redirecting to the is-a.dev site try clearing your cache.
+Once the pull request has been merged your site should be working; if it is still redirecting to the is-a.dev site, try clearing your cache.

src/useful/domain-structure.md

@@ -65,12 +65,6 @@ In the owner object, the fields `username` and `email` are required. You may add
 }
 ```
 
-### `description`
-Describe your domain name and your usage. This is purely for documentation purpose and is optional.
-
-### `repo`
-This is a link to your website repository or your GitHub account. This is purely for documentation purpose and is optional.
-
 ### `records` (required)
 This section is where you specify the DNS records.
 
@@ -237,6 +231,15 @@ Note: Please refer to the [frequently asked questions](https://docs.is-a.dev/faq
       "digest": "C2074462471B81206F792AEC23469EF33DDC53538E8580DCCC92FD130C9A6096"
     }]
 ```
+### `services` (*optional*)
+This section is for the verification records of certain services. Here is an example of all currently available options:
+```json
+"services": {
+    "discord": "dh=examplestring123",
+    "vercel": "vc-domain-verify=example.is-a.dev,example123",
+    "bluesky": "did=did:plc:example123"
+}
+```
 
 ### `proxied` (*optional*)
 Enable Cloudflare proxy for your domain. This is disabled by default. To enable it, add this line of code: