blob: e4ec9c8f3a5523de1eec881472420ce54b81d555 [file] [log] [blame] [view]
Justin Woodc9bbb252020-03-03 10:03:58 -08001# Documentation
Justin Wood88c84262020-04-01 15:20:03 +00002
3## Building and Developing
4
Justin Wood0a9545e2020-04-20 18:15:21 -07005- Documentation about building from the command line can be found in
Grzegorz Ferenc8a4f2f12021-08-16 15:53:49 +02006 [the build guide](guides/BUILDING.md)
Song Guo2090fbe2020-12-11 00:26:35 +08007- Documentation about running [cirque](https://github.com/openweave/cirque)
8 tests can be found in
Markus Becker0e4bc512021-11-09 17:06:23 +01009 [the cirque test guide](../src/test_driver/linux-cirque/README.md)
Justin Wood0a9545e2020-04-20 18:15:21 -070010- 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 Wood88c84262020-04-01 15:20:03 +000013
Justin Wood59969ca2022-07-19 20:07:43 -070014## 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 Wood88c84262020-04-01 15:20:03 +000019## Project Flow
20
clapre20002092021-05-28 17:15:42 -040021- Documentation about general project usage of GitHub, and project tools is
Justin Wood0a9545e2020-04-20 18:15:21 -070022 documented in [the project flow](./PROJECT_FLOW.md)
Justin Wood88c84262020-04-01 15:20:03 +000023
24## Style Guide
25
Justin Wood0a9545e2020-04-20 18:15:21 -070026- Documentation about style is documented in
Gaute Svanes Lundee7347ea2023-01-09 19:43:07 +010027 [the style guide](./style/style_guide.md)
Justin Wood0a9545e2020-04-20 18:15:21 -070028- Additional documentation about more specific files are in the
29 [style folder](./style/)
Justin Wood88c84262020-04-01 15:20:03 +000030
Justin Woode19107e2020-04-01 17:59:52 +000031## Third Party Tools
32
33Some tools and utilities are dependent on third party tools, such as Docker.
34
Justin Wood0a9545e2020-04-20 18:15:21 -070035[Docker](https://www.docker.com) is an excellent way to have stable build
36environments that don't pollute the host OS. It is also much easier to maintain
37stability across multiple host environments. Install stable version of
38[Docker Desktop](https://www.docker.com/products/docker-desktop) relevant to
Rob Walker00c01602020-10-14 18:55:02 -070039your native OS (macOS or Windows). Once installed, you can run docker commands
Justin Wood0a9545e2020-04-20 18:15:21 -070040from the shell/terminal.