BPS Wiki
Table of contents
About
This wiki is dedicated to being a hub for links to useful programs, books, webpages as well as curated articles created by members of the BPS community
Contributing
Any submissions of self created content must include a .md
file describing the content. Whether you’re adding a simple schematic library or an in depth tutorial, it needs to have a dedicated page so people can find it. Unfinished articles are allowed, as along as they are marked as such.
If you’re just adding a link to a book or another website, then that can simply be added to the .md
file of the appropriate category.
Adding an Article
- Make a fork of this repository on GitHub.
- Add your article as a
.md
file in the appropriate folder. If a folder does not exist, create one with the name of an existing category. If the category does not exist, create the category as well. - Add a link to your new article in the
## Articles
section ofindex.md
- Add any assets (pictures, schematic files, etc.) to a folder with the name of the article in the same parent folder. If the article is
/electronics/pyro-channels.md
, then an asset will be placed in/electronics/pyro-channels/schematic1.png
. - Submit a pull request to the main repo and include a short description of your changes
Technical Details
The contents of the wiki are open source so anyone can add to and improve on the wiki. The contents are written in markdown and rendered using jekyll. If you want to contribute to the wiki, it may be a good idea to read the below links.
If you have the VSCode editor, local development of the wiki can be made much easier. The repository is set-up with a dev-container so that you do not have to install jekyll or deal with ruby.
There are vscode tasks setup to build and locally test the wiki as well.