Developer docs for Wormhole
To contribute to the docs,
- Fork the repo
- Make the change locally and commit it to a new branch
- Open a pull request with a description of the change and motivation if necessary
- Pat yourself on the back, you just helped a bunch of devs :raised-hands:
There are scripts in the /scripts directory that are used to auto-generate content.
See the README for details on running these scripts
The SUMMARY.md file is VERY picky, if you try to do something like have two top level (h1) headers, the CI job will never finish. If you're restructuring things, make small changes, CI for gitbook should be very fast.
Examples for writing GitBook flavored markdown:
https://github.com/GitbookIO/git-sync-normalization/blob/master/api-blocks.md https://support.audacityteam.org/community/contributing/tutorials/gitbook-markdown-syntax
You cannot include a dropdown in a tab or vice versa
Add a new line after the {% hint %} directive if you expect formatting like a link to work properly
Use a web utility to scan for dead links like https://www.deadlinkchecker.com/