Update sidebar navigation for version 3.9 of English and Japanese docs

[josh-wong]

Caution

This PR should not be merged until after we're ready to add the displayed_sidebar: docsEnglish configuration to the front-matter properties of English docs and displayed_sidebar: docsJapanese configuration to the front-matter properties of Japanese docs. By adding this configuration, we can specify the appropriate sidebar language that should be displayed for the respective language when the visitor is on a page.

This method follows Docusaurus's method for sidebars, as described in Understanding sidebar association.

Description

This PR updates the sidebar navigation for ScalarDL 3.9 (and will apply to later versions as well). Since we'll be hard-coding titles (labels) in the sidebar navigation in the near future, we should address this now before it becomes an issue.

If we don't specify which sidebar navigation to show for each language, the sidebar navigation for Japanese docs would show in English.

Note

We hard-code the titles (labels) in the sidebar navigation so that we can make the titles shorted in the sidebar navigation while keeping longer titles at the top of each doc. Keeping titles within the actual doc provides readers with better context and is better for SEO.

See an example of the sidebar navigation at:

• https://674ff389d1a359f671379685--scalardl-category-indexes-202412.netlify.app/docs/latest/
  • The sidebar changes exist only for 3.9 docs.

Related issues and/or PRs

• Changes to doc front-matter properties: https://github.com/scalar-labs/docs-internal-scalardl/pull/286

Note

Similar changes are being done in the ScalarDB docs:

• Sidebar changes: Add sidebar navigation for Japanese docs docs-scalardb#762
• Changes to doc front-matter properties: https://github.com/scalar-labs/docs-internal-scalardb/pull/658

Changes made

• Changed the default sidebar name from docs to docsEnglish.
• Added a sidebar structure for Japanese docs (docsJapanese) that matches the English docs.
• Translated the titles (labels) in the docsJapanese sidebar into Japanese.

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.
• 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.

Additional notes (optional)

N/A