dfuse Documentation
We welcome contributions to improve the documentation. Simply open a pull request to start collaborating!
Requirements
- Hugo Extended (with SCSS support), version 0.58.3 or higher
- Install from source (with SCSS support) with:
git checkout github.com/gohugoio/hugo
cd hugo
go install -v --tags extended
Development
To start the hugo server, run this command:
hugo server
Content Structure
All content can be found in the /content
directory. The structure of the website is generated automatically based on the structure of that directory.
Style guide
Links
-
1.1 external: When you insert an external link use the external-link
shortcode
{{< external-link href="https://app.dfuse.io" title="dfuseio" >}}
{{< external-link href="https://app.dfuse.io">}}
-
1.2 internal references: Please put all internal references as full paths, for greppability and refactoring.
Example code
Use the following begin and end tags to indicate code sections that need to be referenced:
// CODE:BEGIN:quickstarts_javascript_node_eos_section1
function() {
var some = "code"
}
// CODE:END:quickstarts_javascript_node_eos_section1
Section names need to follow the path of the file from project root.
For example the example snippet is from the file:
├── quickstarts
│ └── javascript
│ └── node
│ └── index.eos.js
├── guides
└── ...
When hugo builds the site, the code sections are extracted and stored in the data
folder in project root.
Example code can then be referenced with the following shortcode:
{{< code-section "quickstarts_javascript_node_eos_section1" >}}
Lexicon guide
- web application
- website
- dfuse
- real-time
- GraphQL
- API
Deployment
Any commit to master automatically triggers a deployment. For this reason, the master branch is locked, requiring all changes to go through an approved pull request.
Reference
ETH -=> Endpoint ALPHA
side menu
alpha (red)
beta (yeallo-orangy)
stage (light gray)
add sub-title to graphql shortcode
fix
refactor pages