Justin Wood | c9bbb25 | 2020-03-03 10:03:58 -0800 | [diff] [blame] | 1 | # Documentation |
Justin Wood | 88c8426 | 2020-04-01 15:20:03 +0000 | [diff] [blame] | 2 | |
| 3 | ## Building and Developing |
| 4 | |
Justin Wood | 0a9545e | 2020-04-20 18:15:21 -0700 | [diff] [blame] | 5 | - Documentation about building from the command line can be found in |
Grzegorz Ferenc | 8a4f2f1 | 2021-08-16 15:53:49 +0200 | [diff] [blame] | 6 | [the build guide](guides/BUILDING.md) |
Song Guo | 2090fbe | 2020-12-11 00:26:35 +0800 | [diff] [blame] | 7 | - Documentation about running [cirque](https://github.com/openweave/cirque) |
| 8 | tests can be found in |
Markus Becker | 0e4bc51 | 2021-11-09 17:06:23 +0100 | [diff] [blame] | 9 | [the cirque test guide](../src/test_driver/linux-cirque/README.md) |
Justin Wood | 0a9545e | 2020-04-20 18:15:21 -0700 | [diff] [blame] | 10 | - Documentation about standard build & development flows using |
| 11 | [Visual Studio Code](https://code.visualstudio.com/) can be found in |
| 12 | [the development guide](./VSCODE_DEVELOPMENT.md) |
Justin Wood | 88c8426 | 2020-04-01 15:20:03 +0000 | [diff] [blame] | 13 | |
Justin Wood | 59969ca | 2022-07-19 20:07:43 -0700 | [diff] [blame] | 14 | ## Platform Guides |
| 15 | |
| 16 | - Various guides are available [here](./guides/README.md) that cover platform |
| 17 | bring up, testing, and various troubleshooting things. |
| 18 | |
Justin Wood | 88c8426 | 2020-04-01 15:20:03 +0000 | [diff] [blame] | 19 | ## Project Flow |
| 20 | |
clapre | 2000209 | 2021-05-28 17:15:42 -0400 | [diff] [blame] | 21 | - Documentation about general project usage of GitHub, and project tools is |
Justin Wood | 0a9545e | 2020-04-20 18:15:21 -0700 | [diff] [blame] | 22 | documented in [the project flow](./PROJECT_FLOW.md) |
Justin Wood | 88c8426 | 2020-04-01 15:20:03 +0000 | [diff] [blame] | 23 | |
| 24 | ## Style Guide |
| 25 | |
Justin Wood | 0a9545e | 2020-04-20 18:15:21 -0700 | [diff] [blame] | 26 | - Documentation about style is documented in |
Gaute Svanes Lunde | e7347ea | 2023-01-09 19:43:07 +0100 | [diff] [blame] | 27 | [the style guide](./style/style_guide.md) |
Justin Wood | 0a9545e | 2020-04-20 18:15:21 -0700 | [diff] [blame] | 28 | - Additional documentation about more specific files are in the |
| 29 | [style folder](./style/) |
Justin Wood | 88c8426 | 2020-04-01 15:20:03 +0000 | [diff] [blame] | 30 | |
Justin Wood | e19107e | 2020-04-01 17:59:52 +0000 | [diff] [blame] | 31 | ## Third Party Tools |
| 32 | |
| 33 | Some tools and utilities are dependent on third party tools, such as Docker. |
| 34 | |
Justin Wood | 0a9545e | 2020-04-20 18:15:21 -0700 | [diff] [blame] | 35 | [Docker](https://www.docker.com) is an excellent way to have stable build |
| 36 | environments that don't pollute the host OS. It is also much easier to maintain |
| 37 | stability across multiple host environments. Install stable version of |
| 38 | [Docker Desktop](https://www.docker.com/products/docker-desktop) relevant to |
Rob Walker | 00c0160 | 2020-10-14 18:55:02 -0700 | [diff] [blame] | 39 | your native OS (macOS or Windows). Once installed, you can run docker commands |
Justin Wood | 0a9545e | 2020-04-20 18:15:21 -0700 | [diff] [blame] | 40 | from the shell/terminal. |