Driver: Add page about Perl

[amotl]

About

What the title says.

Preview

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

[coderabbitai]

Walkthrough

Adds Perl documentation to the Connect section by updating the drivers index (language card and toctree) and adding a new Perl-specific guide with connection examples using DBD::Pg and a CrateDB Cloud snippet.

Changes

Cohort / File(s)	Summary
Drivers index docs/connect/index.md	Added a Perl grid-item-card in "Drivers by language" (link, alt text, image, caption) and inserted perl/index into the "All drivers" toctree.
Perl connection guide docs/connect/perl/index.md	New page describing connecting to CrateDB from Perl using DBD::Pg, with synopsis, example script, install/run instructions, and a CrateDB Cloud example.

Sequence Diagram(s)

(omitted — documentation additions only)

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

• Driver: Add page about Rust #407 — Modifies docs/connect/index.md to add a language driver card and toctree entry (same file/area).
• Driver: Add page about Go #406 — Adds a language driver card and corresponding language page in the connect drivers area.
• Driver: Add page about Zig #419 — Adds a new language driver page and updates docs/connect/index.md similarly.

Suggested labels

cross linking

Suggested reviewers

• surister
• matriv

Poem

🐰 I hopped into docs with a bright little twirl,
A Perl card planted neatly for every curious squirrel.
DBD::Pg bundled, examples warm and clear,
Now crates and Perl can mingle without fear! ✨

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title 'Driver: Add page about Perl' clearly and concisely describes the main change: adding documentation for the Perl driver.
Description check	✅ Passed	The description relates to the changeset by confirming the addition of a Perl driver documentation page and providing a preview link.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

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

✨ Finishing touches

🧪 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.}

[kneth]

Let's discuss https://github.com/crate/tech-content/issues/124#issuecomment-3485676563 before merging

[amotl]

I guess much is done with Python+FORTRAN today, but I am sure Perl still has a certain representation at NASA, even years after people reported about it.

I was working at NASA until very recently, and there genuinely is so much Perl in use there that all major tools released for mission control systems have Perl APIs.

-- https://www.reddit.com/r/ProgrammerHumor/comments/8452i9/perl_problems/

Perl provides an excellent API to databases known as DBI. ;]

-- https://web.archive.org/web/20041025124130/http://isc.gsfc.nasa.gov/Papers/DOC/Perl-McLean-Final.PDF

References

• https://hesperia.gsfc.nasa.gov/hessi/solar_cd/FAQ/Perl_FAQ.htm
• https://web.archive.org/web/20190527081537/https://www.perlmonks.org/?node_id=103502

[seut]

thx!