Skip to content

update build flag tip #557

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Apr 22, 2025

Conversation

PieWol
Copy link

@PieWol PieWol commented Apr 10, 2025

attempt to fix #534

Since this is a most basic tutorial to start a Parachain, most likely no visitor is in a position to immediately learn about the right flags for production ready compilation. Instead I suggest to remove the misleading wording and simply mention that --release yields a binary for improved runtime performance compared to a regular (debug) build.

@PieWol PieWol marked this pull request as ready for review April 10, 2025 21:24
@PieWol PieWol requested a review from a team as a code owner April 10, 2025 21:24
@eshaben eshaben requested review from nhussein11 and 0xLucca April 14, 2025 00:11
@@ -74,7 +74,7 @@ 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 to build binaries with improved runtime performance compared to a ``--debug`` build.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hey @PieWol , thank you very much for this contribution. Just a minor visual detail here:

Suggested change
Initial compilation may take several minutes, depending on your machine specifications. Use the `--release` flag to build binaries with improved runtime performance compared to a ``--debug`` build.
Initial compilation may take several minutes, depending on your machine's specifications. Use the `--release` flag to build binaries with improved runtime performance compared to a `--debug` build.

Also, could you please run:

python ./scripts/generate_llms.tsx

So the llms.txt is updated accordingly

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Also, #534 mentions adding the production profile, do you think you can add that here as well?

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

+1, I think the intent from the issue is to improve the documentation to help parachains achieve the maximum performance. It would make sense to add information regarding the production profile. I would leave it to you to decide where you think it would be most suited to add this.

@nhussein11
Copy link
Collaborator

Disclaimer: Moving this to another branch to take over and close the PR

@nhussein11 nhussein11 changed the base branch from master to nhussein11/fix-update-build-profiels April 22, 2025 14:16
@nhussein11 nhussein11 merged commit 4e5f1f7 into nhussein11/fix-update-build-profiels Apr 22, 2025
2 of 3 checks passed
@nhussein11 nhussein11 deleted the PieWol-patch-1 branch April 22, 2025 14:16
@nhussein11
Copy link
Collaborator

#575

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

[template tutorial] Explain build profiles
3 participants