This repository establishes a base for Spherity proposals and drafts using respec as a foundation.
This repo includes a number of defaults for the respec template. See respecConfig
for the exact configuration.
- Click on 'Use this template' in the github interface
- Create the new templated repository in your user namespace or Spherity namespace
- Open
index.html
and replace the following variables with your content- Spec Information:
SPEC_TITLE
SPEC_SUBTITLE
- Author Information:
YOUR_NAME
YOUR_WEBSITE
YOUR_COMPANY
YOUR_COMPANY_WEBSITE
- Repository Information:
REPO_LINK
PAGE_URL
- Spec Information:
- Open the
index.html
file in your local browser to preview your draft - Once you are ready, push your changes to your repo.
Please see the respec documentation for an in-depth explanation of all possible options for writing your
proposal. However, a good base can be established by expanding your abstraction definition and including new sections for your proposal.
Some examples are already included in index.html
.
When you update the main
branch of your proposal repository, the resulting content will automatically published to a github page that you can share. Using the default configuration your page should be accessible at:
https://<user>.github.io/<repository>
To activate this feature navigate to Settings > Pages and define an action.