Skip to content
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

Request for small change in documentation - Guides #21923

Open
1 task done
Vyzark opened this issue Jan 29, 2025 · 0 comments
Open
1 task done

Request for small change in documentation - Guides #21923

Vyzark opened this issue Jan 29, 2025 · 0 comments
Labels
status/triage Needs triage

Comments

@Vyzark
Copy link

Vyzark commented Jan 29, 2025

Is this a docs issue?

  • My issue is about the documentation content or website

Type of issue

Other

Description

Good afternoon,
I would to request that a small warning or info "banner" of sorts is added to the guides regarding the time it might take to run the Docker tests or create the first build.
Thanks for your time in writing good documentation and keeping it up-to-date!

Location

https://docs.docker.com/guides/nodejs/run-tests/

Suggestion

I'm a complete beginner to using Docker and during the first build while following the guide I was not prepared for a build time of over 1 hour. It could be nice to add a small warning at the beginning of the guide section or before asking to execute the command saying something like "The first build might take up to X hours" or "Attention, when running for the first time the build can take a long time". It would be nice to have such a warning or info for all steps that could have long running times (experienced the same when running the tests in the "Run your tests" step of the Node.js guide, as it took over 15 minutes to complete).
For reference (if relevant), the build time for the first time building the sample project was a bit over 1 hour and 20 minutes.

Also, could be nice to explain in the docs, or reference another page that explains, which part of the build takes longest to execute and why.

@Vyzark Vyzark added the status/triage Needs triage label Jan 29, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
status/triage Needs triage
Projects
None yet
Development

No branches or pull requests

1 participant