Skip to content

Request for small change in documentation - Guides #21923

Open
@Vyzark

Description

@Vyzark

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.

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions