Driver: Add page about Perl

[amotl]

About

What the title says.

Preview

https://cratedb-guide--418.org.readthedocs.build/connect/perl/

[coderabbitai]

Walkthrough

Added Perl as a driver option in the Connect docs: updated docs/connect/index.md to include a Perl driver grid card and toctree entry, and added a new docs/connect/perl.md with instructions for connecting to CrateDB via DBD::Pg (Perl DBI PostgreSQL driver).

Changes

Cohort / File(s)	Summary
Perl driver card docs/connect/index.md	Inserted a new grid-item-card for Perl in the Drivers by language grid (logo, link, alt text, styling) and added Perl to the All drivers toctree list.
Perl connection guide docs/connect/perl.md	Added new documentation describing prerequisites, installation (DBD::Pg), and a usage example showing DBI/DBD::Pg connection, prepare/execute, and result handling for CrateDB.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

• Connect: Reorganize and clean up section #361: Related changes to the drivers grid and toctree structure that this Perl entry extends.
• Drivers: Fix broken links. Improve wording. #338: Updates to docs/connect/index.md driver cards and listing that overlap with this change.
• Connect: Migrate pages from crate-clients-tools, to be retired soon #221: Earlier connect docs additions that this Perl page builds upon.

Suggested labels

guidance

Suggested reviewers

• kneth
• surister

Poem

🐰 A soft hop through docs I make,
DBD::Pg for Crate I bake.
Lines of code and logos bright,
Perl joins the drivers' gentle light. 🥕

Pre-merge checks and finishing touches

❌ Failed checks (1 inconclusive)

Check name	Status	Explanation	Resolution
Description Check	❓ Inconclusive	The pull request description states "What the title says," which is a circular and highly vague statement that relies entirely on the PR title for meaning. The changeset itself is clearly related to adding Perl documentation (adding Perl to the drivers grid and creating a new Perl driver documentation file), and the PR title "Driver: Add page about Perl" does describe this work. However, the description itself contains no meaningful information or descriptive terms—it is essentially a non-description that provides no additional context beyond what the title already conveys.	While the PR is technically related to the changeset through its title, the description "What the title says" is extremely vague and generic, providing no meaningful information on its own. Consider requesting that the author provide a more substantive description that explains the purpose and scope of adding Perl documentation, rather than deferring entirely to the title.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Title Check	✅ Passed	The pull request title "Driver: Add page about Perl" directly describes the main changes in the changeset. The changes consist of adding Perl as a new driver option to the documentation structure by creating a new Perl driver documentation page (docs/connect/perl.md) and updating the index page (docs/connect/index.md) to include Perl in the drivers grid and toctree. The title clearly communicates this intent with specific references to "Driver" and "Perl" and the action of adding a page.
Docstring Coverage	✅ Passed	No functions found in the changes. Docstring coverage check skipped.

✨ Finishing touches

• 📝 Generate docstrings

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch perl

---

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

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}