How to Make Changes to Documentation
This guide walks you through the steps to make changes or create new guides and documentation on the creator portal.
Option 1: Making Changes via the Web Interface
Follow these steps to make edits to the documentation directly in the GitHub web editor:
- Navigate to the document you want to edit.
- Click on the "Edit" button in the top right corner to open the document in the GitHub web interface editor.
- If you haven't already, fork the repository by clicking on the "Fork" button in the top right corner of the repository page.
- Click on the pencil icon to edit the document directly in the GitHub web interface.
- Add content, make revisions, or suggest changes.
- Click on "Preview" to see how your changes will look.
- Click on the "Commit changes" button to save your edits.
- Add a title and description for your changes.
- Click on the "Propose changes" button to commit your changes.
- After committing your changes, GitHub will prompt you to create a pull request.
- Add a title and description for your pull request.
- Review your changes and click on the "Create pull request" button.
- Wait for feedback from reviewers and address any comments or suggestions.
Option 2: Making Changes Locally with Git
Follow these steps to make changes locally with Git (recommended for advanced users):
-
Navigate to the Creator Studio documentation repository on GitHub.
-
Click on the "Fork" button in the top right corner of the repository page to create a copy of the repository in your GitHub account.
-
Open your forked repository on GitHub and click on the "Code" button.
-
Copy the HTTPS or SSH link provided.
-
Create a new folder on your local machine and open a terminal window.
-
Run the following command to clone the repository to your local machine:
git clone <repository_link>
-
Navigate to the cloned repository on your local machine using the terminal:
cd <repository_name>
-
In the terminal, create a new branch for your changes:
git checkout -b <branch_name>
-
Open the document you want to edit, make your changes, and save the file.
-
Commit your changes:
-
If using the terminal:
-
Add the changes to the staging area:
git add .
-
Commit the changes with a descriptive message:
git commit -m "Your commit message here"
-
Push the changes to your forked repository on GitHub:
git push origin <branch_name>
-
-
If using VS Code:
- Open the source control tab.
- Click on the
+
icon to stage all changes. - Enter a commit message and click on the checkmark icon to commit the changes.
- Click on the three dots icon and select "Push" to push the changes to your forked repository.
-
-
Go to your forked repository on GitHub.
-
Click on the "Pull Request" button.
-
Select the base repository (
pocketzworld/creator-docs
) and the branch you want to merge your changes into. -
Add a title and description for your pull request.
-
Review your changes and click on "Create Pull Request" to submit your changes for review.
-
Wait for feedback from reviewers and address any comments or suggestions.