[FIX] - Update build profiles (#575)

* update build flag tip (#557)

* Update set-up-a-template.md

improve wording

* update compiler flag tip

* fix: build profiles disclaimer

* fix: profile production

---------

Co-authored-by: Piet Wolff <[email protected]>

Author: nhussein11

llms.txt

@@ -33237,7 +33237,9 @@ The [Polkadot SDK Parachain Template](https://github.com/paritytech/polkadot-sdk
     ```
 
     !!!tip
-        Initial compilation may take several minutes, depending on your machine specifications. Always use the `--release` flag to build optimized, production-ready artifacts.
+        Initial compilation may take several minutes, depending on your machine specifications. Use the `--release` flag for improved runtime performance compared to the default `--debug` build. If you need to troubleshoot issues, the `--debug` build provides better diagnostics.
+        
+        For production deployments, consider using a dedicated [`--profile production`](https://github.com/paritytech/polkadot-sdk-parachain-template/blob/v0.0.4/Cargo.toml#L42-L45){target=\_blank} flag - this can provide an additional 15-30% performance improvement over the standard `--release` profile.
 
 4. Upon successful compilation, you should see output similar to:
     <div id="termynal" data-termynal>

tutorials/polkadot-sdk/parachains/zero-to-hero/set-up-a-template.md

@@ -84,7 +84,9 @@ The [Polkadot SDK Parachain Template](https://github.com/paritytech/polkadot-sdk
     ```
 
     !!!tip
-        Initial compilation may take several minutes, depending on your machine specifications. Always use the `--release` flag to build optimized, production-ready artifacts.
+        Initial compilation may take several minutes, depending on your machine specifications. Use the `--release` flag for improved runtime performance compared to the default `--debug` build. If you need to troubleshoot issues, the `--debug` build provides better diagnostics.
+        
+        For production deployments, consider using a dedicated [`--profile production`](https://github.com/paritytech/polkadot-sdk-parachain-template/blob/v0.0.4/Cargo.toml#L42-L45){target=\_blank} flag - this can provide an additional 15-30% performance improvement over the standard `--release` profile.
 
 4. Upon successful compilation, you should see output similar to:
     --8<-- 'code/tutorials/polkadot-sdk/parachains/zero-to-hero/set-up-a-template/compilation-output.html'