Commit Graph

176 Commits

Author SHA1 Message Date
Craig Osterhout 592b28729b
guides: fix port in .net guide (#22269)
<!--Delete sections as needed -->

## Description

The default port changed from 80 to 8080 when we switched to a newer
version of .net in #21877.

https://learn.microsoft.com/en-us/dotnet/core/compatibility/containers/8.0/aspnet-port


https://deploy-preview-22269--docsdocker.netlify.app/guides/dotnet/develop/

https://deploy-preview-22269--docsdocker.netlify.app/guides/dotnet/deploy/

## Related issues or tickets

Closes #22265
Related to #22080
ENGDOCS-2492

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review

---------

Signed-off-by: Craig <craig.osterhout@docker.com>
2025-03-17 15:33:50 -07:00
Craig Osterhout a7a2a5217e
hub: sidebar nav (#22123)
<!--Delete sections as needed -->

## Description

Updated Hub nav items to new left nav.


![image](https://github.com/user-attachments/assets/30fc20be-d999-426e-bef6-55cd535d5735)


## Related issues or tickets

ENGDOCS -2447

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Editorial review
- [ ] Product review

Signed-off-by: Craig <craig.osterhout@docker.com>
2025-03-17 10:07:57 -07:00
Igor Aleksandrov c3431b0474
Rails guide upgrade (part 2) (#22114)
## Description

This PR has two goals. First of all it continues work that has been done
in #21559. Besides this, and this is more significant, I tried to
improve the structure of the documentation that is currently used for
different language-specific guides like
[PHP](https://docs.docker.com/guides/php/configure-ci-cd/),
[Go](https://docs.docker.com/guides/golang/),
[Python](https://docs.docker.com/guides/python/) and others, including,
of course, Ruby itself.

Each of these guides currently has a [Configure
CI/CD](https://docs.docker.com/guides/python/configure-ci-cd/) section.
Inside this section there is a GitHub Actions workflow example that has
nothing in common with a CI/CD pipeline. It's just an example of how to
build and push an image to a Docker Hub registry. We should be clear in
our documentation and not mislead our users. This was the main reason
why I renamed this section to "Automate your builds with GitHub
Actions". I also updated the content of this section to reflect the new
name and to make it more clear what the user can expect from this guide.
I suggest the same be done for all other language-specific guides.

Besides this, I changed the order of the sections in the Ruby guide. The
"Develop your app" section has been moved down to the bottom of the
guide. This makes more sense to me because of two reasons:

1. It is more important to start using Docker Hub right after you added
the Dockerfile to your project (section number one in all
language-specific guides).

2. I can hardly imagine anybody using Docker to run the app locally for
development purposes (at least for Ruby). What is really essential and
useful is to know how to run services, that are required by your app,
like a database, a cache server, or a local LLM. This is why the
"Develop your app" section should be rewritten to explain how to run the
infrastructure services that are required by the app and not the app
itself.

Below there are screenshots reflecting the changes that have been made
in this PR.

**Before**
<img width="1512" alt="Screenshot 2025-02-27 at 11 26 39"
src="https://github.com/user-attachments/assets/1ca06aea-ffeb-4efb-a14d-27254d2a2110"
/>

**After** 
<img width="1512" alt="Screenshot 2025-02-27 at 11 26 01"
src="https://github.com/user-attachments/assets/7abbe8b7-d1b3-480f-8105-49f967b51e47"
/>

## Related issues or tickets

#21559

## Reviews

- [x] Technical review
- [x] Editorial review
- [ ] Product review
2025-03-12 08:08:51 -07:00
Michael Irwin a4237dac3d
Update image source for kafbat
Kafbath publishes its images to Docker Hub, so changing the registry source to Hub instead of GHCR. Also, instead of using the latest tag, they publish merged changes onto a `main` tag.
2025-03-10 14:53:44 -04:00
Igor Aleksandrov eecf21f26e
Change directory after pulling a sample Docker application (#22179)
## Description

This PR updates `git clone` command for sample repositories with `&& cd
<repo name>`. Forcing to change the working directory should reduce the
risk of forgetting to do.

## Related issues or tickets

## Reviews

@usha-mandya 

- [ ] Technical review
- [x] Editorial review
- [ ] Product review
2025-03-06 08:39:12 -08:00
Allie Sadler eb331a22df
Merge pull request #22117 from aevesdocker/ENGDOCS-2451
ENGDOCS-2451
2025-03-06 14:45:54 +00:00
Sarah Sanders 79d037dc5a
Merge pull request #22160 from sarahsanders-docker/tcc-minutes
subscription: add callout about TCC minutes rollovers
2025-03-05 11:10:13 -05:00
Ville Skyttä ae3eec2c70
docs: grammar and spelling fixes (#22136)
<!--Delete sections as needed -->

## Description

<!-- Tell us what you did and why -->

Fix a few grammar and spelling errors.


## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
2025-02-28 14:13:37 -08:00
Mohammad-Ali A'RÂBI 25d4796019
Add multi-stage builds to the C++ guide (#21562)
## Description

Having a multi-stage build is an essential thing to learn for
containerizing a compiled language.

## Related issues or tickets

N/A

## Reviews

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
2025-02-27 09:24:01 -08:00
Craig Osterhout 5138abac63
guides: fix layout (#22118)
<!--Delete sections as needed -->

## Description

There were a couple leftover buttons from when the layout changed and
the buttons became auto-generated. Removed the buttons.

## Related issues or tickets

<!-- Related issues, pull requests, or Jira tickets -->

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Editorial review

Signed-off-by: Craig <craig.osterhout@docker.com>
2025-02-27 08:51:59 -08:00
Igor Aleksandrov 123f79504d
Added missing article on multiple pages (#22098)
## Description

In this PR I added an article that was missing from several similar
pages.

## Reviews

- [ ] Technical review
- [x] Editorial review
- [ ] Product review
2025-02-25 09:35:37 +00:00
Roberto Robles 48084c86e5
Update develop.md
Server port is incorrect, due this issue server cannot be available at http://localhost:8080/
2025-02-21 14:55:48 -06:00
Expeto ceafe3f998
new genai rag guide (#21703)
## Description
Added a new guide about RAG with genAI which also explains how RAG
actually work

## Reviews



- [ ] Technical review
- [x] Editorial review
- [ ] Product review

---------

Signed-off-by: Your Name <you@example.com>
Co-authored-by: Your Name <you@example.com>
Co-authored-by: Baransel SAGINDA <redirecter2@gmail.com>
Co-authored-by: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com>
2025-02-13 14:45:03 -08:00
Craig Osterhout ebb2fe4e34
Merge pull request #21893 from Pradumnasaraf/add-deno
docs: Add language-specific guide for Deno runtime
2025-02-13 10:44:52 -08:00
Craig Osterhout 62f8262a70
Update content/guides/deno/develop.md 2025-02-13 10:38:57 -08:00
Craig Osterhout f7014d35ff
Update content/guides/deno/containerize.md 2025-02-13 10:38:51 -08:00
Pradumna Saraf 75a7f4e338
Update content/guides/deno/deploy.md
Co-authored-by: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com>
2025-02-12 20:32:38 +05:30
Pradumna Saraf 79fd794564
Update content/guides/deno/deploy.md
Co-authored-by: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com>
2025-02-12 20:32:30 +05:30
Pradumna Saraf 188562628e
Update content/guides/deno/containerize.md
Co-authored-by: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com>
2025-02-12 20:32:19 +05:30
Pradumna Saraf 74e0931e5b
Update content/guides/deno/deploy.md
Co-authored-by: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com>
2025-02-12 20:32:11 +05:30
Pradumna Saraf 223d348ddc
Update content/guides/deno/deploy.md
Co-authored-by: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com>
2025-02-12 20:32:04 +05:30
Pradumna Saraf 139fce8441
Update content/guides/deno/configure-ci-cd.md
Co-authored-by: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com>
2025-02-12 20:31:56 +05:30
Pradumna Saraf 996ff65807
Update content/guides/deno/containerize.md
Co-authored-by: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com>
2025-02-12 20:31:51 +05:30
Pradumna Saraf aee0079f97
Update content/guides/deno/containerize.md
Co-authored-by: Craig Osterhout <103533812+craig-osterhout@users.noreply.github.com>
2025-02-12 20:31:43 +05:30
Sarah Sanders d083617e9d
fix: update include.html for heading error (#21906)
## Description
- Problem: Some include shortcodes produce missing H3 ToC headings (ex:
https://docker.slack.com/archives/C039ZM6GH4Z/p1737545677728649)
- Fix: Update to include.html uses Hugo readFile function to fix parsing
errors and updated all include shortcodes using Find and Replace to use
correct syntax: `{{% "include-file" %}}`

## Related issues or tickets
-
[ENGDOCS-2398](https://docker.atlassian.net/browse/ENGDOCS-2398?atlOrigin=eyJpIjoiZGE3OTBmY2ExOTliNDVjY2JlOTc4Y2ViY2MwNDI3NDEiLCJwIjoiaiJ9)

## Reviews
- [ ] Technical review

[ENGDOCS-2398]:
https://docker.atlassian.net/browse/ENGDOCS-2398?atlOrigin=eyJpIjoiNWRkNTljNzYxNjVmNDY3MDlhMDU5Y2ZhYzA5YTRkZjUiLCJwIjoiZ2l0aHViLWNvbS1KU1cifQ
2025-01-29 07:31:40 -08:00
Benoit de Chezelles 0f6df87ef1 guides: Fix cert extension to be auto-added by update-ca-certificates 2025-01-29 13:09:32 +01:00
Brandon Hunt e536caae57
Merge pull request #21877 from brandonh6k/main
Update dotnet to .NET 8.0 (LTS)
2025-01-27 11:33:29 +01:00
Pradumna Saraf 9e5c09a5a1
fix: update repository URL in Deno guides to point to the correct source 2025-01-24 16:41:30 +05:30
Pradumna Saraf 935c0d4a49
docs: add Deno getting started guide with containerization and deployment instructions 2025-01-24 16:36:53 +05:30
Allie Sadler 228cc0f586
Engdocs 2329 (#21847)
<!--Delete sections as needed -->

## Description

Admin guide on user and access management

## Related issues or tickets

<!-- Related issues, pull requests, or Jira tickets -->

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
2025-01-23 15:51:08 +00:00
Igor Alexandrov 98972aa72d Added libyaml-dev to the Rails Dockerfile example 2025-01-15 10:52:03 +04:00
Igor Klimer f42a4ccabe
Fix typo in Java guide for running tests (#21816)
## Description

Fix typo when targeting the `test` stage - it was mentioning a
non-exisiting `--target-test` parameter which could confuse new users:
`unknown flag: --target-test`.
It should be `--target test` or `--target=test`. I went with `--target
test` since that's what is used in the rest of the guide.


## Related issues or tickets

Introduced in https://github.com/docker/docs/pull/19390

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
2025-01-14 14:54:01 -08:00
David Karlsson 644f43d5c9
Merge pull request #21134 from Pradumnasaraf/repo-link-update
docs: Update links to cpp, bun sample repositories
2025-01-14 15:03:41 +01:00
Igor Aleksandrov d7ffb99825
Rails guide upgrade (part 1) (#21559)
## Description

This PR upgrades the Rails framework guide and covers the application
containerization step. In the following PRs, I will update the section
about deploying with Docker Compose, and add a new "Deployment with
Kamal" section.

## Reviews

- [ ] Technical review
- [x] Editorial review
- [ ] Product review
2025-01-14 11:09:18 +01:00
David Karlsson d08fe30d96
Merge pull request #21276 from rw4lll/laravel-compose
Laravel + Docker guide
2025-01-13 14:44:35 +01:00
Sergei Shitikov acf46fb75f guides: Add Docker+Laravel example
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2025-01-13 14:42:02 +01:00
Craig Osterhout c808c6fc40
guides: clarify instruction (#21783)
<!--Delete sections as needed -->

## Description

Clarify instruction so users know that the provided file needs to
edited.

## Related issues or tickets

hotjar-12673

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Editorial review

---------

Signed-off-by: Craig <craig.osterhout@docker.com>
2025-01-10 15:58:29 -08:00
David Karlsson f062709f4b redirects: add alias for /guides/language/
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-12-20 16:47:35 +01:00
Michael Irwin 29a1c25cfc Add links to other guides in container-supported development guide
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-12-18 15:08:03 +01:00
Sarah Sanders 316115fc76
add docker consolidated subscriptions (#21476)
<!--Delete sections as needed -->

## Description

<!-- Tell us what you did and why -->

## Related issues or tickets

- https://docker.atlassian.net/browse/HD-2066

## Reviews

Final sign offs in Notion doc

---------

Co-authored-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com>
Co-authored-by: Oleg Burov <ob1dev@icloud.com>
2024-12-10 08:37:56 -08:00
David Karlsson b2264d26cb guides: add cross-references to gha intro guide
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-12-06 12:55:49 +01:00
David Karlsson 8cd992531d guides: docker build github actions primer
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-12-05 10:05:05 +01:00
CrazyMax e6d3d21f9b
gha: move docker login step up
Signed-off-by: CrazyMax <1951866+crazy-max@users.noreply.github.com>
2024-11-30 22:44:56 +01:00
David Karlsson f22d75d1d0 bake: remove empty build network for compose files
Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
2024-11-28 09:18:45 +01:00
Allie Sadler dd55643d48
ENGDOCS-2330 (#21512)
<!--Delete sections as needed -->

## Description

Update admin guide now that settings management has 2 ways to configure.
And some freshness

## Related issues or tickets

<!-- Related issues, pull requests, or Jira tickets -->

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review
2024-11-27 10:45:45 +00:00
Craig Osterhout 5d12cf6a70
hub: refresh/restructure repo content (#21435)
<!--Delete sections as needed -->

## Description

Started refreshing and reorganizing the Hub manual.

- Moved & rearranged the content from "Docker Hub > Manage repositories"
to "Docker Hub > Repositories > Manage" with the following sections:
  - repo info: description, overview, categories
  - access: visibility, collaborators, teams/permissions, roles, OATs
  - images: tags, software artifacts, push images, move images
- Moved the repository features (automated builds, webhooks,
vulnerability scanning) under "Repositories > Manage".
- Moved/added Create, Delete, and Personal settings to top-level of
Repositories
- Filled in some content gaps

https://deploy-preview-21435--docsdocker.netlify.app/docker-hub/repos/

## Related issues or tickets

ENGDOCS-2227

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review

---------

Signed-off-by: Craig <craig.osterhout@docker.com>
2024-11-21 10:35:40 -08:00
Allie Sadler 42d97aacf8
ENGDOCS-2181c (#21419)
<!--Delete sections as needed -->

## Description

Replaces https://github.com/docker/docs/pull/20646 that was so old it
was still using the `toc.yaml` file.
SME reviews complete. Just need editorial 

## Related issues or tickets

<!-- Related issues, pull requests, or Jira tickets -->

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [x] Editorial review
- [ ] Product review
2024-11-21 14:59:22 +00:00
David Karlsson 1dd73711f9
Merge pull request #21439 from dvdksn/test-refactor
chore: refactor / fix tests
2024-11-16 07:45:19 +01:00
David Karlsson 339522c4bc
Merge pull request #21432 from dvdksn/update-dbc-links
build(cloud): update dbc app links
2024-11-16 07:43:20 +01:00
David Karlsson c8cadbb9c5
Merge pull request #21410 from dvdksn/bake-monorepo-guide
guides: build compose projects with bake
2024-11-15 17:15:09 +01:00