Skip to content

Commit 1de159e

Browse files
feat: remove everything except staking, add console, upgrade (#128)
* feat: remove everything except staking, add console, upgrade * console docs * some fixes * Update docs/build/overview.md * edits (#129) * edits * edits * fix sp * edits * edits * edits * edits --------- Co-authored-by: shamsartem <[email protected]> --------- Co-authored-by: boneyard93501 <[email protected]>
1 parent f33de3b commit 1de159e

File tree

176 files changed

+8061
-15577
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

176 files changed

+8061
-15577
lines changed

.github/CODEOWNERS

+2-3
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,5 @@
66

77
.github/** @nahsi
88

9-
docs/build/** @boneyard93501
10-
docs/aqua-book/** @alari
11-
docs/marine-book/** @mikevoronov
9+
docs/stake/** @justchillinghere
10+
docs/build/** @Fedor4096

README.md

+3-20
Original file line numberDiff line numberDiff line change
@@ -4,30 +4,13 @@ Fluence Docs are built using [Docusaurus 2](https://docusaurus.io/), a modern st
44

55
## Contributing
66

7-
- Generally docs hierarchy should be reflected in the file hierarchy, but ultimately the docs tree must be set up inside `sidebars.js` file. If you put a markdown file inside a directory - don't ever name it `index.md` - use the same name as the directory itself instead (e.g. [basic-concepts.md](./docs/marine-book/basic-concepts/basic-concepts.md))
7+
- Generally docs hierarchy should be reflected in the file hierarchy, but ultimately the docs tree must be set up inside `sidebars.js` file. If you put a markdown file inside a directory - don't ever name it `index.md` - use the same name as the directory itself instead (e.g. [basic-concepts.md](./docs/stake/bridge_guide/bridge_guide.md))
88
- Currently the index page is redirected to `/docs/learn/overview`. This is because we don't have a design of what's best to place on the index page. The redirect is configured in the `vercel.json` file
9-
- Avoid adding a lot of images. Images are added using `![short description of an image](./path-to-an-image.png)` syntax. If you have to add an image - please put it inside the directory near the doc where it is used. Check out [basic-concepts.md](./docs/marine-book/basic-concepts/basic-concepts.md). Please use .png or even better - svg for diagrams and .jpg for photos, resize the image as small as you are comfortable and compress it using [tinypng.com](https://tinypng.com/) (or [svgomg](https://jakearchibald.github.io/svgomg/) for .svg).
9+
- Avoid adding a lot of images. Images are added using `![short description of an image](./path-to-an-image.png)` syntax. If you have to add an image - please put it inside the directory near the doc where it is used. Check out [basic-concepts.md](./docs/stake/bridge_guide/bridge_guide.md). Please use .png or even better - svg for diagrams and .jpg for photos, resize the image as small as you are comfortable and compress it using [tinypng.com](https://tinypng.com/) (or [svgomg](https://jakearchibald.github.io/svgomg/) for .svg).
1010
- When adding ANY github links please use [permalinks](https://docs.github.com/en/get-started/writing-on-github/working-with-advanced-formatting/creating-a-permanent-link-to-a-code-snippet) - otherwise links will point to the wrong place eventually. I also added new experimental markdown related settings to .vscode/settings.json which help a lot with writing valid markdown. Also [this vscode extension](https://marketplace.visualstudio.com/items?itemName=blackmist.LinkCheckMD) can help you find broken external links as well
1111
- Please at least use spell checker inside your editor or maybe Grammarly and be attentive when writing docs - they are the face of the company in a sense
12-
- [Here](https://github.com/fluencelabs/docs/blob/9c6e5a257f453b6dbffb856fc236917908e80602/docusaurus.config.js#L61) is where you can add syntax highlight for other programming languages. Use \`\`\`aqua and \`\`\`air for codeblocks in these languages. Use \`\`\`sh for something that you intend to type in a shell. Maybe don't put \$ signs and execution results right inside \`\`\`sh code-blocks for the following reasons: \$ signs and commands output mixed with all of it make it harder to copy and use the code from the docs and also some of the commands output will be changed by us and will have to be maintained in the docs as well which is very inconvenient.
12+
- Use \`\`\`sh for something that you intend to type in a shell. Maybe don't put \$ signs and execution results right inside \`\`\`sh code-blocks for the following reasons: \$ signs and commands output mixed with all of it make it harder to copy and use the code from the docs and also some of the commands output will be changed by us and will have to be maintained in the docs as well which is very inconvenient.
1313
- Headings are not just a stylistic tool but also semantic one. Headings are used to give document a structure which is especially important for page navigation for certain people and also for generating valid quick navigation tree that is displayed on the right side of the docs. So basically the main rule is to not skip heading levels (e.g. don't do #Heading followed immediately by ###Heading - use ##Heading instead)
14-
- For `mermaid` code to work you would currently need to do the following:
15-
````markdown
16-
Some text that you have in your md
17-
18-
mermaid
19-
```mermaid
20-
graph YourDiagram;
21-
A-->B;
22-
A-->C;
23-
B-->D;
24-
C-->D;
25-
```
26-
27-
rest of the text on your page
28-
````
29-
Notice the blank line before and after the mermaid section
30-
- TODO: would be cool to have docs near the code (e.g. put Marine docs to Marine repo) - I think it can be done with CI build process but I think there unfortunately is no out-of-the-box solution. If it would be possible - changelogs from github and fluence-js docs, etc. could be included in these docs
3114

3215
## Installation
3316

docs/aqua-book/aqua-js-api.md

-84
This file was deleted.

0 commit comments

Comments
 (0)