Address comments

Author: ddoktorski

CHANGELOG.md

@@ -19,7 +19,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Updated the error message returned when calling a nonexistent method on a contract to better align with the format used by the network
 - Oracle support in `snforge` is now stable and no longer requires the `--experimental-oracles` CLI flag
-- The default tracked resource is now Sierra gas, so gas reporting results may differ compared to previous versions
+- The default tracked resource is now Sierra gas, so gas reporting results may differ compared to previous versions. For more information refer to the [documentation](https://foundry-rs.github.io/starknet-foundry/testing/gas-and-resource-estimation.html)
 - When using the `--detailed-resources` flag, the used Sierra gas key is now shown as `sierra gas` instead of `sierra_gas_consumption`
 
 ### Cast

docs/src/appendix/snforge/test.md

@@ -118,9 +118,9 @@ Enabling this flag will slow down the compilation process, but the built contrac
 ## `--tracked-resource`
 
 Set tracked resource for test execution. Impacts overall test gas cost. Valid values:
-- `cairo-steps` (default): track cairo steps, uses vm `ExecutionResources` (steps, builtins, memory holes) to describe  resources consumed by the test.
-- `sierra-gas` (sierra 1.7.0+ is required): track sierra gas, uses cairo native `CallExecution` (sierra gas consumption) to describe computation resources consumed by the test.
-To learn more about fee calculation formula (and an impact of tracking sierra gas on it) please consult [starknet docs](https://docs.starknet.io/learn/protocol/fees#overall-fee)
+- `sierra-gas` (default): track sierra gas, uses cairo native `CallExecution` (sierra gas consumption) to describe computation resources consumed by the test.
+- `cairo-steps`: track cairo steps, uses vm `ExecutionResources` (steps, builtins, memory holes) to describe resources consumed by the test.
+To learn more about fee calculation formula (and the impact of tracking sierra gas on it) please consult [starknet docs](https://docs.starknet.io/learn/protocol/fees#overall-fee)
 
 ##  `-P`, `--profile` `<PROFILE>`
 Specify the profile to use by name.

docs/src/testing/gas-and-resource-estimation.md

@@ -14,8 +14,8 @@ When the test passes with no errors, estimated gas is displayed this way:
 [PASS] tests::simple_test (l1_gas: ~1, l1_data_gas: ~1, l2_gas: ~1)
 ```
 
-This gas calculation is based on the estimated VM resources (that you can [display additionally on demand](#usage)), 
-deployed contracts, storage updates, events and l1 <> l2 messages. 
+This gas calculation is based on the collected VM resources or Sierra gas (that you can [display additionally on demand](#usage)),
+storage updates, events and l1 <> l2 messages.
 
 ### Fuzzed Tests
 
@@ -33,10 +33,10 @@ While using the fuzzing feature additional gas statistics will be displayed:
 
 It is possible to enable more detailed breakdown of resources, on which the gas calculations are based on.
 Depending on `--tracked-resource`, vm resources or sierra gas will be displayed.
-To learn more about tracked resource flag, see [--tracked-resource](../appendix/snforge/test.md#--tracked-resource).
+To learn more about the tracked resource flag, see [--tracked-resource](../appendix/snforge/test.md#--tracked-resource).
 
 ### Usage
-In order to run tests with this feature, run the `test` command with the appropriate flag:
+In order to run tests with this feature, run the `test` command with the `--detailed-resources` flag:
 
 ```shell
 $ snforge test --detailed-resources --tracked-resource cairo-steps

docs/src/testing/running-tests.md

@@ -138,13 +138,6 @@ To track resources like `builtins` / `syscalls` that are used when running tests
 $ snforge test --detailed-resources
 ```
 
-> 📝 **Note**
->
-> The default resource tracked by snforge is Sierra gas.
-> To view VM resources used during execution, run the command with `--tracked-resource cairo-steps`.
-> For more information about different resources refer to the [Starknet documentation](https://docs.starknet.io/learn/protocol/fees#vm-resources-vs-sierra-gas). 
->
-
 <details>
 <summary>Output:</summary>