Skip to content

Add wrangler check startup docs #19877

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 5 commits into from
Apr 7, 2025
Merged

Conversation

penalosa
Copy link
Contributor

@penalosa penalosa commented Feb 10, 2025

Summary

Adds docs for the new wrangler check startup docs

Documentation checklist

  • The documentation style guide has been adhered to.
  • If a larger change - such as adding a new page- an issue has been opened in relation to any incorrect or out of date information that this PR fixes.
  • Files which have changed name or location have been allocated redirects.

Copy link
Contributor

@hyperlint-ai hyperlint-ai bot left a comment

Choose a reason for hiding this comment

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

2 files reviewed, 1 total issue(s) found.

Copy link
Contributor

@irvinebroque irvinebroque left a comment

Choose a reason for hiding this comment

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

Awesome. Think might help to have step by step? Even if feels a bit silly, many people haven't done it before — ex: run command, then take file, put in chrome devtools over here, voila

@mikenomitch

Copy link
Contributor

@hyperlint-ai hyperlint-ai bot left a comment

Choose a reason for hiding this comment

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

Hyperlint Review is complete!

Hyperlint Vale Style Guide Review

Reviewed 2 files and found 1 issues.

See the inline comments and suggestions below.

Hyperlint Link Check Review

Reviewed 2 files and found 0 issues.


We are upgrading our reviewer model! Going forward, our model will learn your particular style - which comments you all accept and reject, so that it can further personalize its suggestions.

What is Hyperlint?

Hyperlint is an AI agent that helps you write, edit, and maintain your documentation. It can review, edit, and suggest fixes for your documentation.

Learn more about the Hyperlint AI reviewer and the checks that we can run on your documentation.

- `--worker` <Type text="string" /> <MetaInfo text="optional" />
- If you don't use Wrangler to deploy your Worker, you can use this argument to provide a Worker bundle to analyse. This should be a file path to a serialized multipart upload, with the exact same format as [the API expects](/api/resources/workers/subresources/scripts/methods/update/).
- `--pages` <Type text="boolean" /> <MetaInfo text="optional" />
- If you don't use a Wrangler config file with your Pages project (i.e. a Wrangler config file containing `pages_build_output_dir`), use this flag to force `wrangler check startup` to treat your project as a Pages project.
Copy link
Contributor

Choose a reason for hiding this comment

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

Identified issues

  • Vale Style Guide - (cloudflare.LatinTerms-warning) Use 'that is' instead of 'i.e.', but consider rewriting the sentence.

Proposed fix

Suggested change
- If you don't use a Wrangler config file with your Pages project (i.e. a Wrangler config file containing `pages_build_output_dir`), use this flag to force `wrangler check startup` to treat your project as a Pages project.
- If you don't use a Wrangler config file with your Pages project (that is, a Wrangler config file containing `pages_build_output_dir`), use this flag to force `wrangler check startup` to treat your project as a Pages project.

I replaced 'i.e.' with 'that is' as per the style guide's recommendation. This change improves clarity and adheres to the style guide without altering the meaning of the sentence.

@penalosa
Copy link
Contributor Author

Awesome. Think might help to have step by step? Even if feels a bit silly, many people haven't done it before — ex: run command, then take file, put in chrome devtools over here, voila

Are you thinking a guide with screenshots? I wonder if it might be helpful to record a short video walkthrough e.g. here's how you generate the flame graph, here what it looks like, here's what you can do with it cc @rickyrobinett

I think we can probably get this in as is and iterate though?

@penalosa penalosa force-pushed the penalosa/startup-profiling branch from d78aa18 to abffdfb Compare April 7, 2025 09:46
Copy link
Contributor

hyperlint-ai bot commented Apr 7, 2025

Howdy and thanks for contributing to our repo. The Cloudflare team reviews new, external PRs within two (2) weeks. If it's been two weeks or longer without any movement, please tag the PR Assignees in a comment.

We review internal PRs within 1 week. If it's something urgent or has been sitting without a comment, start a thread in the Developer Docs space internally.


PR Change Summary

Added documentation for the new wrangler check startup command, enhancing the existing content related to Worker startup time profiling.

  • Introduced wrangler check startup command documentation.
  • Updated existing documentation to include information about CPU profiling for Worker startup.
  • Clarified usage of wrangler check startup with examples and options.

Modified Files

  • src/content/docs/workers/platform/limits.mdx
  • src/content/docs/workers/wrangler/commands.mdx

How can I customize these reviews?

Check out the Hyperlint AI Reviewer docs for more information on how to customize the review.

If you just want to ignore it on this PR, you can add the hyperlint-ignore label to the PR. Future changes won't trigger a Hyperlint review.

Note specifically for link checks, we only check the first 30 links in a file and we cache the results for several hours (for instance, if you just added a page, you might experience this). Our recommendation is to add hyperlint-ignore to the PR to ignore the link check for this PR.

penalosa and others added 5 commits April 7, 2025 11:12
Co-authored-by: hyperlint-ai[bot] <154288675+hyperlint-ai[bot]@users.noreply.github.com>
Co-authored-by: Brendan Irvine-Broque <[email protected]>
Co-authored-by: ToriLindsay <[email protected]>
@penalosa penalosa force-pushed the penalosa/startup-profiling branch from abffdfb to 79e0e85 Compare April 7, 2025 10:12
@penalosa penalosa merged commit b0f48e0 into production Apr 7, 2025
11 checks passed
@penalosa penalosa deleted the penalosa/startup-profiling branch April 7, 2025 10:40
RebeccaTamachiro pushed a commit that referenced this pull request Apr 21, 2025
* Add check startup docs

* Update src/content/docs/workers/wrangler/commands.mdx

Co-authored-by: hyperlint-ai[bot] <154288675+hyperlint-ai[bot]@users.noreply.github.com>

* Apply suggestions from code review

Co-authored-by: Brendan Irvine-Broque <[email protected]>
Co-authored-by: ToriLindsay <[email protected]>

* Update commands.mdx

* fix link

---------

Co-authored-by: ToriLindsay <[email protected]>
Co-authored-by: hyperlint-ai[bot] <154288675+hyperlint-ai[bot]@users.noreply.github.com>
Co-authored-by: Brendan Irvine-Broque <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
product:workers Related to Workers product size/s
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants