Contribute to documentation

Author:Anthony

Prerequisite

Step by step

  1. Clone your forked repo:

    git clone https://github.com/<You username>/dotcom
    
  2. Change to the directory:

    cd dotcom
    

    If you want to see you new docs live on your localhost:

    1. Install dependencies:

      npm install
      
    2. Start the development server:

      npm run dev
      

    Now, the website should be running at http://localhost:3000. It will support live reload upon code changes.

  3. Go to consts folder and open up author.ts.

  4. Add you name and links under the const authorList: Author[] section in the following format:

    {
        name: "Your name",
        email: "Your email", //optional
        url: "Your website link", //optional
        github: "Your github usename", //optional
        twitter: "Your twitter handle", //optional
        funding: "Your funding link", //optional
    },
    
  5. Go to content/docs/ and open up index.md.

  6. Add the name and link of you document in the desired section.

    Note: If it's a single document with no relation to existing section, add it to the Others section. If it's a serveral document requiring a new section, create a new section using the markdown's headings 2.

  7. Create corresponding markdown files under the content folder in the corresponding location.

    Note: If it's a whole new section you are adding:

    1. Create the corresonding folder under content

    2. Add a index.md file inside you newly created folder

    3. Copy what you added in step 6. to the index.md

    4. Replace the title in ## with:

          ---
          title: <Your title>
          ---
      
  8. Add this on top you makrdown file, change the variables accordingly:

        ---
        title: <Your title>
        author: <You name(the one you just put in author.ts)>
        ---
    
  9. Enjoy writing you documentation!