Skip to content

Conversation

josh-wong
Copy link
Member

@josh-wong josh-wong commented Aug 26, 2024

Description

This PR adds support for tags in the docs header below the title. These tags are shown so that readers can see if the doc they are reading:

  • applies to a specific edition (Community, Enterprise Standard, and/or Enterprise Premium),
  • is an add-on, or
  • is a feature in private or public preview.

This PR effectively turns what was previously the ScalarDB Enterprise docs site into the ScalarDB docs site, which includes docs for both Community and Enterprise editions.

Related issues and/or PRs

Changes made

  • Swizzled the DocItem/Footer, DocVersionBadge, and TagsListInline components.
    • Moved tags from the bottom of docs to the top of docs.
  • Added styles for tag button design.
  • Added plugins for Font Awesome icon.
    • The question mark button, which points to the Scalar product pricing page, uses a Font Awesome icon.
  • Enlarged the text in the badge area where the version and tags are.

Checklist

The following is a best-effort checklist. If any items in this checklist are not applicable to this PR or are dependent on other, unmerged PRs, please still mark the checkboxes after you have read and understood each item.

  • I have updated the side navigation as necessary. N/A
  • I have commented my code, particularly in hard-to-understand areas.
  • I have updated the documentation to reflect the changes. N/A
  • Any remaining open issues linked to this PR are documented and up-to-date (Jira, GitHub, etc.).
  • My changes generate no new warnings.
  • Any dependent changes in other PRs have been merged and published. N/A

Additional notes (optional)

N/A

josh-wong added 19 commits May 18, 2024 02:09
Since we want to have tags at the top of the page we should hide them from the footer.
Make tags more likely to be seen at first glance on a page by adding components here.
Add styles to make tags on the same line as `Version` and provide styles to make it look decent in the dark theme.
Add Font Awesome components and question-mark icon. The question-mark icon links to our pricing page, which shows features for the available editions.
These styles are no longer necessary after swizzling the `TagsListInline` component and changing `Tags` to `Editions`.
If `Edition` is right aligned, the spacing is awkward if the screen becomes narrow on both desktop and mobile. In such case, at least for now, aligning the `Edition` tags below the version number is less awkward.
Change component name, which was changed in Docusaurus 3.5.0.
Since we'll be showing tags other than editions, we've decided to remove "Editions" from the badge area at the top of the page.
@josh-wong josh-wong added the enhancement New feature or request label Aug 26, 2024
@josh-wong josh-wong self-assigned this Aug 26, 2024
Copy link

netlify bot commented Aug 26, 2024

Deploy Preview for staging-scalardb-enterprise-doc-reorg ready!

Name Link
🔨 Latest commit d187d03
🔍 Latest deploy log https://app.netlify.com/sites/staging-scalardb-enterprise-doc-reorg/deploys/66e39c8981ea6d00082835b7
😎 Deploy Preview https://deploy-preview-469--staging-scalardb-enterprise-doc-reorg.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
1 paths audited
Performance: 48
Accessibility: 95
Best Practices: 92
SEO: 89
PWA: 80
View the detailed breakdown and full score reports

To edit notification comments on pull requests, go to your Netlify site configuration.

@josh-wong josh-wong changed the title Add support for tags in doc header Add support for tags in docs header Aug 26, 2024
josh-wong added a commit that referenced this pull request Sep 18, 2024
This announcement is to notify visitors that the docs for both ScalarDB Community and Enterprise editions are available on this docs site. The editions are displayed as tags, which is implemented in #469.
@josh-wong josh-wong marked this pull request as ready for review September 24, 2024 07:50
@josh-wong josh-wong merged commit 3e3c2d3 into main Sep 24, 2024
1 check passed
@josh-wong josh-wong deleted the add-support-for-tags-in-doc-header branch September 24, 2024 07:51
josh-wong added a commit that referenced this pull request Sep 24, 2024
…Enterprise docs (#595)

* Create index.tsx

* Comment out tags in footer

Since we want to have tags at the top of the page we should hide them from the footer.

* Create index.tsx

* Add tags to top of page

Make tags more likely to be seen at first glance on a page by adding components here.

* Add styles for tags at top of page

Add styles to make tags on the same line as `Version` and provide styles to make it look decent in the dark theme.

* Change tag header from `Tags:` to `Editions:`

* Add Font Awesome plugins

* Add styles for Font Awesome question-mark icon

* Add Font Awesome components and question-mark icon

Add Font Awesome components and question-mark icon. The question-mark icon links to our pricing page, which shows features for the available editions.

* Add tooltip for question-mark button/link

* Add tooltip style and border to tags on hover

* Create styles.module.css

* Create index.tsx

* Remove unnecessary styles

These styles are no longer necessary after swizzling the `TagsListInline` component and changing `Tags` to `Editions`.

* Make `Edition` left-aligned

If `Edition` is right aligned, the spacing is awkward if the screen becomes narrow on both desktop and mobile. In such case, at least for now, aligning the `Edition` tags below the version number is less awkward.

* Change component name

Change component name, which was changed in Docusaurus 3.5.0.

* Justify align tags with version

* Comment out "Editions"

Since we'll be showing tags other than editions, we've decided to remove "Editions" from the badge area at the top of the page.

* Add tags

* Add tags

* Remove awkward margin spacing on mobile

* Add announcement about unified docs for editions

This announcement is to notify visitors that the docs for both ScalarDB Community and Enterprise editions are available on this docs site. The editions are displayed as tags, which is implemented in #469.

* Fix styling for announcement bar

The close button in the announcement bar was too low and aligned in the middle of the banner.

* Fix issue with tags being left aligned in Firefox

* Fix collapse button background for Firefox

* Revert "Merge branch 'add-support-for-tags-in-doc-header' into announcement/add-notice-about-community-and-enterprise-docs-site"

This reverts commit 71f4978, reversing
changes made to b14409d.

* Revert "Merge branch 'add-support-for-tags-in-doc-header' into announcement/add-notice-about-community-and-enterprise-docs-site"

This reverts commit ffd9945, reversing
changes made to a4ae874.

* Revise message in announcement banner
josh-wong added a commit that referenced this pull request May 14, 2025
* Create index.tsx

* Comment out tags in footer

Since we want to have tags at the top of the page we should hide them from the footer.

* Create index.tsx

* Add tags to top of page

Make tags more likely to be seen at first glance on a page by adding components here.

* Add styles for tags at top of page

Add styles to make tags on the same line as `Version` and provide styles to make it look decent in the dark theme.

* Change tag header from `Tags:` to `Editions:`

* Add Font Awesome plugins

* Add styles for Font Awesome question-mark icon

* Add Font Awesome components and question-mark icon

Add Font Awesome components and question-mark icon. The question-mark icon links to our pricing page, which shows features for the available editions.

* Add tooltip for question-mark button/link

* Add tooltip style and border to tags on hover

* Create styles.module.css

* Create index.tsx

* Remove unnecessary styles

These styles are no longer necessary after swizzling the `TagsListInline` component and changing `Tags` to `Editions`.

* Make `Edition` left-aligned

If `Edition` is right aligned, the spacing is awkward if the screen becomes narrow on both desktop and mobile. In such case, at least for now, aligning the `Edition` tags below the version number is less awkward.

* Change component name

Change component name, which was changed in Docusaurus 3.5.0.

* Justify align tags with version

* Comment out "Editions"

Since we'll be showing tags other than editions, we've decided to remove "Editions" from the badge area at the top of the page.

* Add tags

* Add tags

* Remove awkward margin spacing on mobile

* Fix issue with tags being left aligned in Firefox
josh-wong added a commit that referenced this pull request May 14, 2025
…Enterprise docs (#595)

* Create index.tsx

* Comment out tags in footer

Since we want to have tags at the top of the page we should hide them from the footer.

* Create index.tsx

* Add tags to top of page

Make tags more likely to be seen at first glance on a page by adding components here.

* Add styles for tags at top of page

Add styles to make tags on the same line as `Version` and provide styles to make it look decent in the dark theme.

* Change tag header from `Tags:` to `Editions:`

* Add Font Awesome plugins

* Add styles for Font Awesome question-mark icon

* Add Font Awesome components and question-mark icon

Add Font Awesome components and question-mark icon. The question-mark icon links to our pricing page, which shows features for the available editions.

* Add tooltip for question-mark button/link

* Add tooltip style and border to tags on hover

* Create styles.module.css

* Create index.tsx

* Remove unnecessary styles

These styles are no longer necessary after swizzling the `TagsListInline` component and changing `Tags` to `Editions`.

* Make `Edition` left-aligned

If `Edition` is right aligned, the spacing is awkward if the screen becomes narrow on both desktop and mobile. In such case, at least for now, aligning the `Edition` tags below the version number is less awkward.

* Change component name

Change component name, which was changed in Docusaurus 3.5.0.

* Justify align tags with version

* Comment out "Editions"

Since we'll be showing tags other than editions, we've decided to remove "Editions" from the badge area at the top of the page.

* Add tags

* Add tags

* Remove awkward margin spacing on mobile

* Add announcement about unified docs for editions

This announcement is to notify visitors that the docs for both ScalarDB Community and Enterprise editions are available on this docs site. The editions are displayed as tags, which is implemented in #469.

* Fix styling for announcement bar

The close button in the announcement bar was too low and aligned in the middle of the banner.

* Fix issue with tags being left aligned in Firefox

* Fix collapse button background for Firefox

* Revert "Merge branch 'add-support-for-tags-in-doc-header' into announcement/add-notice-about-community-and-enterprise-docs-site"

This reverts commit 71f4978, reversing
changes made to b14409d.

* Revert "Merge branch 'add-support-for-tags-in-doc-header' into announcement/add-notice-about-community-and-enterprise-docs-site"

This reverts commit ffd9945, reversing
changes made to a4ae874.

* Revise message in announcement banner
josh-wong added a commit that referenced this pull request Oct 7, 2025
The Community docs are present in the main ScalarDB docs site based on tag (#469), so this note is no longer needed
josh-wong added a commit that referenced this pull request Oct 7, 2025
The Community docs are present in the main ScalarDB docs site based on tag (#469), so this note is no longer needed
josh-wong added a commit that referenced this pull request Oct 7, 2025
* Remove note about Community docs being elsewhere

The Community docs are present in the main ScalarDB docs site based on tag (#469), so this note is no longer needed

* Apply suggestion from Gemini
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant