You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
To contribute to the specification, please submit a pull request by:
forking the repo
editing the appropriate markdown files in the /spec folder
The specification is rendered from the markdown files to the index.html specification file in the /docs folder
using Spec-Up. The full guidance for using SpecUp is in that documentation.
The short version of the instructions for this repository is:
Install prerequisites: node and npm
Run npm install from the root of the repository
Run npm run edit from the root of the repository to render the document with live updates to the docs/index.html. You can see the updates as you make as you edit the markdown files. Open the rendered file in a browser and refresh to see the updates as you work.
You can also run npm run render to just generate the specification file once.
When you create a PR to update the specification, please DO NOT include docs/index.html. A GitHub Action on merge of PRs automagically
renders for the full specification (docs/index.html) to the gh-pages branch in the repo and the specification is
published from there. If there is a way to .gitignore the index.html in the main branch but not in the gh-pages branch, please let us know.
Hint: One way to revert the updated docs/index.html before doing a commit, is to run: git checkout -- docs/index.html
Editing the spec in the cloud with Gitpod
An alternative way to contribute to the specification, without any local installation, is to use Gitpod.
Fork the repo.
Open https://gitpod.io/#https://github.com/YOUR_FORK_USER/indy-did-method
Register with Gitpod using your GitHub Account and provide public_repo permissions in order to commit to your fork from Gitpod.
You'll see a prepared VSCode workspace with two windows. To the left, you can edit the markdown files in the /spec folder. To the right, you'll see the rendered spec.
If the window is frozen try to reload the page.
You can create a new branch and commit and push your changes using a terminal or the source control plugin to the left.