Skip to content

docs(guides): add two testcontainers intro guides (go and python)#24450

Open
mdelapenya wants to merge 7 commits intodocker:mainfrom
mdelapenya:testcontainers-guides
Open

docs(guides): add two testcontainers intro guides (go and python)#24450
mdelapenya wants to merge 7 commits intodocker:mainfrom
mdelapenya:testcontainers-guides

Conversation

@mdelapenya
Copy link
Member

@mdelapenya mdelapenya commented Mar 20, 2026

Description

Migrate the first two Testcontainers getting-started guides from testcontainers.com/guides into the Docker docs site:

  • Getting started with Testcontainers for Go — multi-page guide with 4 chapters (create project, write tests, test suites, run tests). Code updated to testcontainers-go v0.41.0 API (postgres.Run(), CleanupContainer, BasicWaitStrategies()).
  • Getting started with Testcontainers for Python — multi-page guide with 3 chapters (create project, write tests, run tests). Code updated to testcontainers-python 4.14.2 (fixed get_exposed_port() returning int).

Each guide appears as its own entry in the /guides/ listing with proper language and tag filters (testing-with-docker). Chapters render with stepper navigation in the sidebar.

Also adds:

  • A testing-with-docker tag to data/tags.yaml
  • A Claude skill (.claude/skills/testcontainers-guides-migrator/SKILL.md) that documents the repeatable migration process for the remaining 19 guides
  • Links from content/manuals/testcontainers.md to the new guides
  • Vale vocabulary entries for pgx, Micronaut, psycopg, pytest

All guide code was compiled and tests verified passing in containers with Docker socket mounted.

Related issues or tickets

No related issues found.

Reviews

  • Technical review
  • Editorial review
  • Product review

@netlify
Copy link

netlify bot commented Mar 20, 2026

Deploy Preview for docsdocker ready!

Name Link
🔨 Latest commit a721938
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/69bda0fa6e183300070acdf6
😎 Deploy Preview https://deploy-preview-24450--docsdocker.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Copy link
Contributor

@docker-agent docker-agent bot left a comment

Choose a reason for hiding this comment

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

Assessment: 🟡 NEEDS ATTENTION

This PR adds two new Testcontainers getting-started guides (Go and Python) with good structure and content. However, there's an issue with the Go version prerequisite that needs correction.

@mdelapenya
Copy link
Member Author

Regarding the bot's comments about Go 1.25+:

Go 1.25 is the correct minimum version. testcontainers-go v0.41.0 specifies go 1.25.0 in its go.mod (with toolchain go1.25.7). We verified compilation and tests pass with golang:1.25-alpine.

The bot's knowledge cutoff predates the Go 1.25 release.

@mdelapenya
Copy link
Member Author

/review

Copy link
Contributor

@docker-agent docker-agent bot left a comment

Choose a reason for hiding this comment

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

Assessment: 🟢 APPROVE

This PR adds two comprehensive Testcontainers getting-started guides (Go and Python) migrated from testcontainers.com. The documentation is well-structured, follows Docker style guidelines, and includes all necessary supporting infrastructure.

Strengths:

  • ✅ All front matter complete with required fields (title, description, keywords)
  • ✅ No AI-isms, hedge words, or marketing language detected
  • ✅ Code examples follow state-show-explain pattern
  • ✅ Appropriate use of callouts (NOTE, TIP)
  • ✅ Proper console code blocks with $ prompts
  • ✅ Clear, factual explanations without passive voice
  • ✅ Vale vocabulary updated for technical terms (pgx, psycopg, pytest)
  • ✅ New testing-with-docker tag added correctly
  • ✅ Manual page updated with guide links

No issues found - This is high-quality documentation ready to merge.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant