Set up your doc site
Most ConsenSys documentation sites are built using Docusaurus, a static site generator optimized for technical documentation. See the Docusaurus documentation for general information about creating and maintaining a Docusaurus site.
This page walks you through setting up a Docusaurus site for ConsenSys documentation. You'll use this template repository to set up your doc repository.
Ensure you have permission in the ConsenSys GitHub organization to create a new repository. If you don't have permission, request it from ConsenSys Help Desk, which administers the GitHub organization.
Go to this repository on GitHub.
Select the green Use this template button, and Create a new repository.
Fill out the details for your fork from the template. You can prefix the repo with
docs-and then include your project name. For example,
Choose Public, Internal, or Private depending on your needs. For internal repositories, any member of the ConsenSys GitHub organization can see your repository by default, whereas private repositories are completely hidden except to GitHub administrators of the organization.
After creating the repository, navigate to the Settings page which is on the far right side of the Code tab.
Ensure that the following settings are enabled/disabled on the General tab:
- ❌ Template repository
- ❌ Wikis
- ✅ Issues
- ✅ Allow forking
- ❌ Sponsorships
- ❌ / ✅ Discussions
- ❌ / ✅ Projects
- Pull Requests
- ❌ Allow merge commits
- ✅ Allow squash merging
- ❌ Allow rebase merging commits
- ❌ / ✅ Always suggest updating pull request branches
- ❌ Allow auto-merge
- ✅ Automatically delete head branches
Go to the Collaborators and teams under Access on the left sidebar. Select Add teams, and add protocol-pliny to add the ConsenSys developer docs team. Add any other teams, such as your own, as needed.
It's currently not possible to easily use branch protection on
mainwhen using the
semantic-releaseplugin. If you disable this, then you can enable branch protection.
You've set up your new doc site! See how to run and preview your site locally.