Matthias Kretschmann
a1d06d323b
|
||
|---|---|---|
| .github | ||
| .husky | ||
| content | ||
| data | ||
| docs | ||
| src | ||
| static | ||
| .env.sample | ||
| .eslintrc | ||
| .gitignore | ||
| .markdownlint.json | ||
| .prettierignore | ||
| .prettierrc | ||
| Dockerfile | ||
| LICENSE | ||
| README.md | ||
| config.js | ||
| docker-compose.yml | ||
| gatsby-browser.js | ||
| gatsby-config.js | ||
| gatsby-node.js | ||
| package-lock.json | ||
| package.json | ||
README.md
docs
🐬 Ocean Protocol documentation. https://docs.oceanprotocol.com
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:
- Documentation: Content →
- Documentation: API References →
- Documentation: GitHub Data Fetching →
- Documentation: Repository Component →
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:
- ESLint with eslint-config-oceanprotocol
- markdownlint
- Prettier
# 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 Vercel with their GitHub integration. A link to a deployment will appear under each Pull Request.
The latest deployment of the main branch is automatically aliased to oceanprotocol.com.
Manual Deployment
If needed, app can be deployed manually. Make sure to switch to Ocean Protocol org before deploying:
# first run
vercel login
vercel switch
# deploy
vercel
# switch alias to new deployment
vercel alias
License
Copyright ((C)) 2021 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.