Skip to content

docs: Add missing TC languages and reorder docs navigation#1711

Merged
HofmeisterAn merged 4 commits into
developfrom
feat/canonical-language-list
Jun 23, 2026
Merged

docs: Add missing TC languages and reorder docs navigation#1711
HofmeisterAn merged 4 commits into
developfrom
feat/canonical-language-list

Conversation

@mdelapenya

@mdelapenya mdelapenya commented Jun 23, 2026

Copy link
Copy Markdown
Member

Align header dropdown and landing page card-grid with the canonical language list: Java, Go, .NET, Node.js, Python, Rust, Ruby, PHP, Haskell, Clojure, Elixir, Scala, Native.

  • Add PHP, Clojure, Elixir, Scala, Native to header dropdown and card-grid
  • Fix ordering to match canonical list
  • Add missing logo SVGs

Summary by CodeRabbit

Documentation

  • Expanded the “supported languages” documentation cards to include and reorganize Rust, Ruby, PHP, Haskell, Clojure, Elixir, Scala, and Native (with updated clickable targets).
  • Improved the Docs language submenu so selected language links open externally in new tabs and display external-link indicators, including an updated Rust destination.

Align header dropdown and landing page card-grid with the canonical
language list: Java, Go, .NET, Node.js, Python, Rust, Ruby, PHP,
Haskell, Clojure, Elixir, Scala, Native.

- Add PHP, Clojure, Elixir, Scala, Native to header dropdown and card-grid
- Fix ordering to match canonical list
- Add missing logo SVGs (php, clojure, elixir, scala, c/native)
@mdelapenya
mdelapenya requested a review from a team as a code owner June 23, 2026 08:54
@netlify

netlify Bot commented Jun 23, 2026

Copy link
Copy Markdown

Deploy Preview for testcontainers-dotnet ready!

Name Link
🔨 Latest commit 19b3272
🔍 Latest deploy log https://app.netlify.com/projects/testcontainers-dotnet/deploys/6a3a4d41a6c5ae000759d105
😎 Deploy Preview https://deploy-preview-1711--testcontainers-dotnet.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.

@coderabbitai

coderabbitai Bot commented Jun 23, 2026

Copy link
Copy Markdown

Review Change Stack

Walkthrough

The docs site is updated to expand language support visibility: the index page card grid gains entries for Rust, Ruby, PHP, Clojure, Elixir, Scala, and Native, while the header navigation template marks those same language submenu items as external links (new tab + icon) and updates Rust's documentation URL.

Changes

Language Navigation Expansion

Layer / File(s) Summary
Index page language card grid
docs/index.md
Replaces the prior condensed Rust/Haskell/Ruby card entries with an expanded set of cards for Rust, Ruby, PHP, Clojure, Elixir, Scala, and Native, updating link URLs and standardizing anchor/image markup for each.
Header submenu external link flags
docs/theme/partials/tc-header.html
Adds "external": true to Java, Go, Node.js, Rust, Ruby, PHP, Clojure, Elixir, and Scala submenu entries enabling new-tab rendering; updates Rust's URL to point to https://rust.testcontainers.org/.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~5 minutes

Poem

🐇 Hop hop, more languages join the crew,
Rust, Elixir, PHP, and Clojure too!
New cards bloom across the page so bright,
External links now open to the right.
The warren grows with every tab and true! 🌿

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description check ✅ Passed The description addresses the mandatory sections: it explains WHAT changes were made and WHY (aligning with canonical language list). However, it is missing the 'Related issues' and 'How to test this PR' sections from the template.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Title check ✅ Passed The title accurately reflects the main changes: adding missing Testcontainers languages (PHP, Clojure, Elixir, Scala, Native) and reordering documentation navigation to match the canonical language list.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch feat/canonical-language-list

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: c0406e89bd

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread docs/index.md

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Actionable comments posted: 3

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@docs/index.md`:
- Around line 55-76: Add `alt=""` attributes to all the `<img>` tags that
display language logos (Rust, Ruby, PHP, Haskell, Clojure, Elixir, Scala, and
Native). Since each card already contains visible text labels identifying the
language, these icons are decorative and should use empty alt text for
accessibility compliance and to prevent lint errors.

In `@docs/theme/partials/tc-header.html`:
- Around line 98-100: The Testcontainers Native (C/C++) entry that points to the
external GitHub URL is missing the "external": true property which other sibling
external language entries have. Add "external": true to the Testcontainers
Native language entry object to ensure it receives consistent new-tab and icon
behavior with the other external language links.
- Around line 40-42: The `.NET` child item object is missing the `url` property,
but the template renders child items as anchors using `href="{{ child.url }}"`,
which results in a broken link with an empty href. Either restore the `url`
property with an appropriate value for the `.NET` item (with label
"Testcontainers for .NET" and image "/language-logos/dotnet.svg"), or modify the
template logic to conditionally render the item as a non-link element when the
url is not present, ensuring the link contract is fulfilled or the item degrades
gracefully.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 2383ca6a-dc97-4ac2-a5f2-d4182c634065

📥 Commits

Reviewing files that changed from the base of the PR and between d6cf08d and c0406e8.

⛔ Files ignored due to path filters (5)
  • docs/language-logos/c.svg is excluded by !**/*.svg
  • docs/language-logos/clojure.svg is excluded by !**/*.svg
  • docs/language-logos/elixir.svg is excluded by !**/*.svg
  • docs/language-logos/php.svg is excluded by !**/*.svg
  • docs/language-logos/scala.svg is excluded by !**/*.svg
📒 Files selected for processing (2)
  • docs/index.md
  • docs/theme/partials/tc-header.html

Comment thread docs/index.md Outdated
Comment thread docs/theme/partials/tc-header.html
Comment thread docs/theme/partials/tc-header.html
@mdelapenya

Copy link
Copy Markdown
Member Author

Fixed across all PRs: added width="30" height="30" to the <svg> element in scala.svg on all branches. A viewBox-only SVG has no intrinsic size so it renders as 0×0 when no dimensions are specified — the fix makes it consistent with every other language logo in the repo.

@mdelapenya

Copy link
Copy Markdown
Member Author

Addressed review comments:

@HofmeisterAn HofmeisterAn changed the title Add missing languages and reorder docs navigation docs: Add missing TC languages and reorder docs navigation Jun 23, 2026
@HofmeisterAn HofmeisterAn added the documentation Docs, docs, docs. label Jun 23, 2026
@HofmeisterAn
HofmeisterAn merged commit 1282048 into develop Jun 23, 2026
8 checks passed
@HofmeisterAn
HofmeisterAn deleted the feat/canonical-language-list branch June 23, 2026 10:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Docs, docs, docs.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants