Skip to content

Conversation

josh-wong
Copy link
Member

@josh-wong josh-wong commented Sep 18, 2024

Description

This PR enables the announcement bar in Docusaurus and provides a message stating that the ScalarDB docs site now includes both Community and Enterprise docs.

Related issues and/or PRs

Changes made

  • Uncommented the announcement bar section in docusaurus.config.js and added a message about the ScalarDB docs site now having both Community and Enterprise docs.
  • Modified the style for the close button in the announcement bar.
  • Although not completely related to this original PR, fixed an issue with the collapse button showing as transparent in Firefox.

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. N/A
  • 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.

Additional notes (optional)

N/A

josh-wong added 30 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.
…dd-notice-about-community-and-enterprise-docs-site
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.
The close button in the announcement bar was too low and aligned in the middle of the banner.
…dd-notice-about-community-and-enterprise-docs-site
@josh-wong josh-wong added the announcement & notifications Related to the announcement bar and notifications in Docusaurus label Sep 18, 2024
@josh-wong josh-wong self-assigned this Sep 18, 2024
…cement/add-notice-about-community-and-enterprise-docs-site"

This reverts commit 71f4978, reversing
changes made to b14409d.
…cement/add-notice-about-community-and-enterprise-docs-site"

This reverts commit ffd9945, reversing
changes made to a4ae874.
@josh-wong josh-wong marked this pull request as ready for review September 24, 2024 07:52
Copy link

netlify bot commented Sep 24, 2024

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

Name Link
🔨 Latest commit b9b6627f1979130d19bc14edcdea9c49905908a7
🔍 Latest deploy log https://app.netlify.com/sites/staging-scalardb-enterprise-doc-reorg/deploys/66f2729ca0080f00086cab2d
😎 Deploy Preview https://deploy-preview-595--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: 71
Accessibility: 97
Best Practices: 92
SEO: 88
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 force-pushed the announcement/add-notice-about-community-and-enterprise-docs-site branch from b9b6627 to 4d44d71 Compare September 24, 2024 08:13
@josh-wong josh-wong merged commit 54375a9 into main Sep 24, 2024
1 check passed
@josh-wong josh-wong deleted the announcement/add-notice-about-community-and-enterprise-docs-site branch September 24, 2024 08:19
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
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

announcement & notifications Related to the announcement bar and notifications in Docusaurus

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant