Update to docs on actions.json support

Signed-off-by: worksofliam <[email protected]>

Author: worksofliam

docs/pages/cli/make.md

@@ -26,7 +26,7 @@ So that means that 4 objects are going to be rebuilt. Usually, parents always ne
 
 ### When is a incremental build right?
 
-It is always recommended to do a incremental build when working in a new branch. Ensure that you have a library of objects from a previous full build on the library list!
+It is always recommended to do a incremental build when working in a new branch. Ensure that you have a library of objects from a previous full build on the library list.
 
 ## `iproj.json` properties
 
@@ -43,6 +43,39 @@ If you are making use of service programs, Source Orbit will automatically maint
 
 ## Changing compile options
 
+When you use `so -bf make`, Source Orbit will generate a makefile that contains the compile commands for each object. The compile commands can come from two places
+
+### Setting up generic compiles (`actions.json`)
+
+The `actions.json` standard determines how files that match specific extensions are compiled. The file is typically created by a user and is located in `.vscode/actions.json`. The `actions.json` standard comes from Code for IBM i and is now used by Source Orbit.
+
+Check out how to use the `actions.json` file in the [Code for IBM i documentation](https://codefori.github.io/docs/developing/local/actions/).
+
+#### Multiple levels of actions
+
+The `.vscode/actions.json` is the default location for the `actions.json` file. However, you can also create a `actions.json` file in a specific directory, which will be merged with the default one. This allows you to have directory specific actions, while still using the defaults.
+
+```
+.vscode:
+  actions.json      ## Actions defined here apply to the entire project
+
+qddssrc:
+  actions.json      ## Actions defined here only apply to qddssrc
+  department.table
+  employee.table
+  emps.dspf
+  nemp.dspf
+
+qrpglesrc:
+  depts.pgm.sqlrpgle
+  empdet.sqlrpgle
+  employees.pgm.sqlrpgle
+  mypgm.pgm.rpgle
+  newemp.pgm.sqlrpgle
+```
+
+### Changing project wide compiles (`iproj.json`)
+
 The `iproj.json` can contain a `compiles` property to customize how each extension type gets compiled. To generate the defaults, you can use `so --init` to create or update the `iproj.json` file. When you define an extension in the `compiles` property, the properties of it will override the `so` defaults.
 
 Here is the schema for the compiles option:
@@ -68,7 +101,7 @@ interface CompileData {
 };
 ```
 
-### Example: build object from commands
+#### Example: build object from commands
 
 Objects like data areas do not have source. In the `compiles` property, there is a flag that can be used to tell Source Orbit to get the commands from the source.