Add Perl + MongoDB Quickstart (Addressed review feedback)

[Akshat005Chaudhary]

Summary

This PR re-submits the Perl + MongoDB Quickstart after addressing feedback from the previous review.

Ref: #774

---

Updates Based on Review

1. Yes keploy record and keploy test usage for both Docker and local setups are clearly documented for the ease of beginners, with explicit references to sections being attacked below.

Keploy Record in local setup

Keploy Test in local setup

Keploy Record in Docker setup

Keploy Test in Docker setup

2. Confirmed the correctness of sidebar entry, denying any concerns regarding removal or tampering of the sidebar entry instrumental for the guide to be discoverable in the docs navigation.

3. The Perl+MongoDB sample app reference in the guide is confirmed to be publicly accessible and the running of the application is reproducible in a clean environment.
4. I have rebased on latest main and resolved merge conflicts
5. Furthermore, the quickstart guide provided follows consistent narrative style and structure with overall docs enhancing readability and usage.

---

Notes

All feedback from the previous review has been addressed.
Happy to make further improvements if needed.

[Akshat005Chaudhary]

Hi @amaan-bhati , resubmitting this PR after addressing all previous review comments (Ref: #774). Would appreciate another look.

[amaan-bhati]

Thanks for resubmitting and addressing the previous feedback given on #774. A few things still need to be fixed that i've segregated into blocking, should fix and nit picks:

Blocking

• Sidebar duplication (versioned_sidebars/version-4.0.0-sidebars.json): The diff accidentally introduces duplicate CI/CD Integration entries (now appears 3x) and a duplicate Test Coverage Integration. There's also a K8s Proxy category added here that has nothing to do with this PR - looks like a bad conflict resolution during rebase. Please clean this up; it'll break the v4.0.0 sidebar.

• Missing unversioned doc: The guide is only added under versioned_docs/version-4.0.0/. The links in QuickStartList.js point to /docs/quickstart/perl-mongo/ which resolves to the current/unversioned docs - that file doesn't exist, so the filter cards will 404. You need a docs/quickstart/perl-mongo.md as well.

• Sample app in personal repo: Both clone commands point to your personal GitHub account. All other quickstarts use github.com/keploy/.... Once you are 100% sure on self review on your personal repo, let me know, i'll tell you where exactly to create a pr to add the sample app.

Should fix

• The anchor links in QuickStartList.js don't match the actual heading slugs. E.g. the Docker heading is ## How to run the sample application Using Docker Compose 🐳 but the link uses #running-app-using-docker-compose-. Double-check both anchors.

• Local keploy test command is missing --delay - the Docker version has it (--delay 10). Add it for consistency.

• Heading levels in the local section are inconsistent - subsections jump to ## where the Docker section uses ###. Keep them ###.

Nits

• "Keploy with capture" → "will capture" (appears twice)
• shortUrl: "http://localhost:5000QWERTY" is missing a / - should be http://localhost:5000/QWERTY
• Image alt text is literally alt text in both places - make it descriptive, helps in seo and image failure as well.

[Akshat005Chaudhary]

Hi @amaan-bhati,

I have addressed all the PR feedback. Here is a summary of the changes:

Blocking

• Sidebar duplication: Cleaned up the duplicate CI/CD Integration and incorrect K8s Proxy and Test Coverage entries in versioned_sidebars/version-4.0.0-sidebars.json.
• Missing unversioned doc: Added docs/quickstart/perl-mongo.md to prevent 404s when browsing unversioned docs.
• Sample App Ownership: Updated the repository URLs in all clone/run instructions to point to the official Keploy location (https://github.com/keploy/samples-perl.git). Let me know once the repository is created so I can submit the sample application PR there!

Should Fix

• Anchor Links: Standardized the headings to ensure their auto-generated slugs match the anchor links in QuickStartList.js (#running-app-using-docker-compose- and #running-app-locally-on-linuxwsl-).
• Commands: Added the missing --delay 10 flag to the local keploy test command.
• Heading Consistency: Converted all subsections in the local section from ## to ### to match the Docker section.

Nits

• Fixed typos (Keploy with capture -> Keploy will capture).
• Added the missing / in the shortUrl example (http://localhost:5000/QWERTY).
• Added descriptive alt text to all quickstart images.

I've successfully verified the build locally with npm run build. Please review and merge. Thanks!

[amaan-bhati]

Good progress here, most of the previous issues have been addressed. The sample app is now under the keploy org, the unversioned doc is included, sidebar is clean, anchor links look correct, and the --delay flag is in both test commands. Just a few small things left to fix.

One thing to note: whatever changes are needed in docs/quickstart/perl-mongo.md apply equally to versioned_docs/version-4.0.0/quickstart/perl-mongo.md since both files are identical. Please update both together.

[amaan-bhati]

Link is imported here but never used anywhere in the file. Can you remove this import?

[amaan-bhati]

"This is return" should be "This will return". Same issue appears again in the local setup section further down, please fix both.

[amaan-bhati]

"This is give error" should be "This will give an error". Same issue appears in the local setup section too.

[amaan-bhati]

The heading says Linux/WSL but the install instructions below cover macOS (brew install cpanminus) and Windows (cpan App::cpanminus) as well. Either update the heading to "Running App Locally on Linux/WSL/macOS" to reflect the actual content, or decide to drop the macOS/Windows steps if the intent is strictly Linux/WSL.

[amaan-bhati]

There's a trailing space inside the backtick here: `-c ` should be `-c`. Small but it renders with the space included.

[Akshat005Chaudhary]

Hi @amaan-bhati,

I have addressed the review feedback and pushed the updates:

1. Unused Import: Removed the unused Link import at the top of the file.
2. Grammar Fixes: Corrected "This is return" to "This will return" and "This is give error" to "This will give an error" across both the docker-compose and local setup sections.
3. Local Setup Heading: Updated the heading to "Running App Locally on Linux/WSL/macOS" to align with the macOS instructions listed below.
4. Command Flag Formatting: Removed the trailing space inside the backticks for the -c flag.

Both the unversioned and versioned docs have been updated. Ready for your review!