Awesome
<br /> <br /> <p align="center"> <img src="website/static/docs/assets/near_logo.png" width="240"> </p> <br /> <br />NEAR Protocol - scalable and usable blockchain
This is the repository for the official documentation of NEAR Protocol, a user-friendly and carbon-neutral blockchain, built from the ground up to be performant, secure, and infinitely scalable.
Quick start
Check out the following links
- Deployed, live documentation: https://docs.near.org
- Example applications: https://github.com/near-examples
- Community chat: https://near.chat
Contributing
NEAR uses Docusaurus for documentation. Please refer to their documentation for details on major structural contributions to the documentation.
For simple content changes you have 2 options
- Submit an issue
- Submit a pull request (we prefer PRs of course)
The instant PR
This is the fastest way to submit content changes directly from the page where you notice a mistake.
- Open any page in the docs on https://docs.near.org
- Click the
[ Edit ]
button at the top right hand side of every content page - Make your edits to the document that opens in GitHub by clicking the ā (pencil) icon
- Submit a PR with your changes and comments for context
The typical PR
This is the standard fork-branch-commit workflow for submitting pull requests to open source repositories
-
Fork this repo to your own GitHub account (or just clone it directly if you are currently a member of NEAR)
-
Open your editor to the top level repo folder to view the directory structure as seen below
-
Move into the
/website
folder where you will run the following commands:-
Make sure all the dependencies for the website are installed:
# Install dependencies yarn
-
Run the local docs development server
# Start the site yarn start
Expected Output
# Website with live reload is started LiveReload server started on port 35729 Docusaurus server started on port 3000
The website for docs will open your browser locally to port
3000
-
-
Make changes to the docs
-
Observe those changes reflected in the local docs
-
Submit a pull request with your changes - Please check for broken links before opening PR š
Directory Structure
Your project file structure should look something like this with a few key files and folders highlighted
āāā CODE_OF_CONDUCT.md
āāā CONTRIBUTING.md
āāā LICENSE-APACHE.txt
āāā LICENSE-MIT.txt
āāā README.md <-- the document you are reading right now
āāā docs <-- all the content for the site is in this folder as markdown files
āāā website
āāā build
āāā core
āāā i18n
āāā package.json
āāā pages
āāā sidebars.js <-- rarely used for changing left-hand-side page navigation
āāā docusaurus.config.js <-- rarely used for general site configuration (including header links)
āāā static
āāā test-links.sh <-- always used to test links before submitting changes
Found a broken link?
For broken links internal to the docs, please submit an issue or PR request as per above.
If you found a broken link from a Google search, please request to remove it from their index here: https://www.google.com/webmasters/tools/removals
Check for broken links
Before opening a pull request, please check for broken links:
yarn test
or id you are in the ./website
directory:
yarn full-test