serinko
7e16932c4a
* initialise ccc event pages * compose existing FAQs * edit flow * restructure faq * add vpn install steps * add testing section * initialise troubleshooting * note add warning * add warning * add run cli steps * add args * document running flow * add mulwald info to args desc * add consent warning * add FAQ questions * add FAQ questions * syntax fix * edit guide flow * add error troubleshooting point * add warning to use two gateways * remove reduntant message * add clarification on testing * rename to 37c3 to respect convention * delete mixnet overview, replace with a link * delete redundant * grammar tweaks * add gui config steps * syntax fix * syntax fix * add releases and simple command info * syntax edits * add clarification on test logs * describe TUN and IP flag * add embedded video * spellcheck --------- Co-authored-by: mfahampshire <mfahampshire@pm.me>
Nym Developer Portal
Developer Portal for the Nym privacy platform built using the mdBook docs framework. Deployed version can be found here.
Contributing
Contributions to our documentation are very welcome. Please work on your contribution in either a feature/<feature-name> or chore/<chore-name> branch from master and target your pull request at master.
Changes merged to master will be autodeployed to the production site.
Adding community projects and resources
If you have built a project with Nym or are compiling and writing resources about Nym, we want to include your work in the community-resources/ section to share with the rest of the community! Just follow the existing formatting and add your project to the page, then put in a pull request.
Variables
There are some variables that are shared across this book, such as the current latest software version.
Variables are denoted in the .md files wrapped in {{}} (e.g {{wallet_release_version}}), and are located in the book.toml file under the [preprocessor.variables.variables] heading. If you are changing something like the software release version, minimum code versions in prerequisites, etc, check in here first!
Building
When working locally, it is recommended that you use mdbook serve to have a local version of the docs served on localhost:3000, with hot reloading on any changes made to files in the src/ directory.
You can find other commands in the mdBook CLI tool docs.
I tried to edit files in theme/ and they aren't taking effect / mdbook serve causes a looping reload on file changes after changing fields in [preprocessor.theme] config
Looping reload is a known issue with the mdbook-theme preprocessor used for the table of contents and layout of these docs. As outlined in the mdbook-theme readme one way to mitigate this is to set turn-off = true under [preprocessor.theme]. This means that mdbook serve or mdbook watch ignores changes to the theme/ directory, which is the source of the looping reload. If you have changed or commented out this line, reintroduce it to remove the looping reload. If you are trying to edit the theme of the docs and want to apply the change, see here for more info on how to remove the block, change the theme, and reintroduce the block.