Bug: Missing description text for HubSpot and Salesforce destinations

[Jivi-this-side]

Heyya 🌻 ! I’m an open-source enthusiast currently exploring the project, and while browsing the Destinations documentation page I noticed a small issue. I’d be happy to help contribute if needed.

Description

On the Jitsu Docs Destinations page, the description text for HubSpot and Salesforce cards is not rendered correctly.

Instead of a proper description, the UI displays:

[//] hidden)

This appears to be a Markdown comment that is leaking into the rendered UI.

---

Steps to Reproduce

1. Go to the Jitsu Docs website.
2. Navigate to Destinations.
3. Locate the cards for HubSpot and Salesforce.

---

Expected Behavior

Each destination card should display a proper description (similar to other destinations like Mixpanel or PostHog).

Example:

HubSpot is a CRM platform that provides marketing, sales, and customer service tools.

---

Actual Behavior

---

Possible Cause

This may be caused by a Markdown comment being incorrectly parsed or rendered in the documentation page.

---

Additional Note

If this is a known issue, I’d be happy to try fixing it and open a PR. Let me know if I can contribute to resolving it.

[github-actions]

This issue is stale because it has been open for 60 days with no activity.

[jagannalla]

Hi maintainers! 🌻 I dug into the root cause of this issue and have a ready-made fix for you to apply to the private docs Docusaurus repository.

Root Cause Analysis

Docusaurus automatically extracts the first non-header paragraph of an MDX file as the page description for directory index cards if there is no explicit description declared in the page frontmatter (YAML).

1. Salesforce: The card displays [//] hidden) because Docusaurus parsed the leaked markdown comment [//]: # (hidden) at the top of the file as body text.
2. HubSpot: The card has no description because there is no plain text paragraph preceding the interactive code blocks.

The Fix

To fix this, we need to add the description frontmatter field explicitly and remove/format the comment. Here are the diffs to apply:

destinations/salesforce.mdx

```diff

sidebar_label: Salesforce
+description: "Salesforce is a leading CRM platform. Jitsu's Salesforce destination allows you to create, update, upsert and delete records for any object type."

-[//]: # (hidden)

Salesforce

```

destinations/hubspot.mdx

```diff

sidebar_label: Hubspot
+description: "HubSpot is a CRM platform. Jitsu sends data to HubSpot API and updates contacts and company records."

-[//]: # (hidden)

Hubspot

```

Applying these frontmatter descriptions will ensure the cards render correctly on the Destinations category page. Thanks!

[github-actions]

This issue is stale because it has been open for 60 days with no activity.