🐍 Ocean Protocol's official documentation https://docs.oceanprotocol.com
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
dependabot[bot] 2e66d92289
Bump eslint from 7.32.0 to 8.16.0
12 hours ago
.github limit test runs, fix TOC 2 months ago
.husky fix pre-commit hook 1 year ago
content Merge pull request #990 from oceanprotocol/issue-989-asset-hosting-services 6 days ago
data Issue-#989: Use singular form in section 6 days ago
docs Merge pull request #936 from oceanprotocol/v4 2 months ago
src Issue-#968: Add a check before rendering 404 3 weeks ago
static sitemap tweaks 3 years ago
.codeclimate.yml Fix: Lint issue 11 months ago
.env.sample copy updates 4 years ago
.eslintrc fix eslint 1 year ago
.gitignore Issue-#850: Aquarius rest api 3 months ago
.markdownlint.json Fix linter issues 2 months ago
.nvmrc add nvmrc 1 year ago
.prettierignore ignore external docs for linting 4 years ago
.prettierrc package updates 2 years ago
Dockerfile add Docker 4 years ago
LICENSE Initial commit 4 years ago
README.md 2021 -> 2022 3 months ago
config.js Issue-#953: Move fees page to concepts 1 month ago
docker-compose.yml add Docker 4 years ago
gatsby-browser.js package updates 2 years ago
gatsby-config.js Issue-#850: Aquarius rest api 3 months ago
gatsby-node.js Issue-#921: Include pre-release 2 months ago
package-lock.json Bump eslint from 7.32.0 to 8.16.0 12 hours ago
package.json Bump eslint from 7.32.0 to 8.16.0 12 hours ago

README.md

banner

docs

🐬 Ocean Protocol documentation. https://docs.oceanprotocol.com

Build Status Netlify Status Maintainability js oceanprotocol css bigchaindb


These docs are meant to be viewed on docs.oceanprotocol.com. You can still browse them here but links or images might not work in some places.

If you want to contribute to these docs, then keep reading.


Content

To write or update content, refer to the documentation of the documentation:

Development

The site is a React app built with Gatsby, pulling its content from local and external Markdown files, and from various APIs.

To start, clone this repo and set your GITHUB_TOKEN (see GitHub GraphQL API):

git clone git@github.com:oceanprotocol/docs.git
cd docs/

# add GITHUB_TOKEN
cp .env.sample .env
vi .env

Then install dependencies and start up the development server:

npm i
npm start

Alternatively, you can use Docker Compose to do the same, but without using your local system:

docker-compose up

Either one of these commands will expose a hot-reloading server under:

Linting & Formatting

To enforce a consistent code style, linting is setup for pretty much every file. Linting is part of the test suite, meaning builds on Travis will fail in case of linting errors.

In this repo the following tools are setup for that:

# only run linting checks
npm run lint

# auto-formatting of all js, css, md, yml files
npm run format

Editor Setup: VS Code

If you use VS Code as your editor, you can install those extensions to get linting as you type, and auto-formatting as you save:

Deployment

Every branch or Pull Request is automatically deployed by Netlify with their GitHub integration. A link to a preview deployment will appear under each Pull Request.

The latest deployment of the main branch is automatically aliased to docs.oceanprotocol.com.

License

Copyright ((C)) 2022 Ocean Protocol Foundation Ltd.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.