Skip to content

[feat]: Restructure public dashboard docs with get-started tutorial and split pages#23869

Open
sujitnewrelic wants to merge 11 commits intodevelopfrom
NR-528104-get-started-public-dashboards
Open

[feat]: Restructure public dashboard docs with get-started tutorial and split pages#23869
sujitnewrelic wants to merge 11 commits intodevelopfrom
NR-528104-get-started-public-dashboards

Conversation

@sujitnewrelic
Copy link
Copy Markdown
Contributor

@sujitnewrelic sujitnewrelic commented Apr 28, 2026

Key changes

  • New page: get-started-sharing-dashboards-publicly.mdx — step-by-step tutorial that walks users through the complete setup flow: Advanced Compute prerequisite check → enable Live URL Creation policy (per account, via NerdGraph) → configure access management (custom role + group) → create and share a live URL. Modeled on the Kafka self-hosted doc structure using <Steps> component.
  • New page: share-dashboards-publicly.mdx — standalone reference doc for dashboard sharing. Splits out from the old combined doc. Includes redirect from the old URL (share-charts-dashboards-externally).
  • New page: share-charts-publicly.mdx — focused, simplified reference doc for chart sharing only. Includes redirect from the old #chart anchor URL.
  • Deleted: share-charts-dashboards-externally.mdx — replaced by the two split docs above.
  • Navigation update (dashboards.yml): Added nested "Share publicly" section with all three new pages in order.
  • Updated 9 English source files with corrected links pointing to the new split doc paths.

Addresses

NR-528104 — Enhance Public Dashboards Documentation with Guided Tutorial

Test plan

  • Verify yarn verify-mdx passes (confirmed: 0 MDX errors)
  • Confirm navigation renders correctly under Dashboards > Share dashboards and charts > Share publicly with all three new pages
  • Confirm get-started-sharing-dashboards-publicly page loads and <Steps> component renders correctly
  • Confirm share-dashboards-publicly page loads with all collapsers functional
  • Confirm share-charts-publicly page loads cleanly
  • Confirm old URL share-charts-dashboards-externally redirects to share-dashboards-publicly
  • Confirm old #chart anchor URL redirects to share-charts-publicly
  • Confirm all updated internal links resolve correctly (NerdGraph docs, introduction-dashboards, manage-your-dashboard, etc.)
  • Review with PM Christian Martinez and Patty before publish

🤖 Generated with Claude Code

… docs

- New: get-started-sharing-dashboards-publicly.mdx — step-by-step tutorial
  covering Advanced Compute check, Live URL Creation policy enablement,
  access management, and creating a live URL (NR-528104)
- New: share-dashboards-publicly.mdx — reference doc for dashboard sharing
  only, with redirect from old combined page URL
- New: share-charts-publicly.mdx — focused reference doc for chart sharing
  only, with redirect from old combined page anchor
- Deleted: share-charts-dashboards-externally.mdx — replaced by two split docs
- Updated navigation to nest three new pages under "Share publicly" section
- Updated 9 English source files to point links to new split doc paths

Co-Authored-By: Claude <noreply@anthropic.com>
@github-actions
Copy link
Copy Markdown

Hi @sujitnewrelic 👋

Thanks for your pull request! Your PR is in a queue, and a writer will take a look soon. We generally publish small edits within one business day, and larger edits within three days.

Please ensure the propsed changes look good by building it first in your local environment. Refer to this contribution guide to get the site up and running in your local.

If you really require a preview url, reach out to one of the writers and they will generate one for you.

Deleted orphaned translation files across es, fr, jp, kr, and pt locales
following removal of share-charts-dashboards-externally.mdx and other
upstream source file deletions. Run via yarn i18n-utility delete-orphans.

Co-Authored-By: Claude <noreply@anthropic.com>
@sujitnewrelic
Copy link
Copy Markdown
Contributor Author

netlify build

@github-actions
Copy link
Copy Markdown

github-actions Bot commented Apr 28, 2026

🚀 Netlify Preview Building!

If the build is successful, the preview for this pull request will be available at the following URL (usually takes 10-20 minutes):

https://nr-528104-get-started-public-dashboards--docs-website-netlify.netlify.app

Restores 47 translated files that were deleted by the delete-orphans run.
i18n files should not be modified as part of this documentation update.

Co-Authored-By: Claude <noreply@anthropic.com>
@sujitnewrelic sujitnewrelic self-assigned this Apr 29, 2026
@sujitnewrelic sujitnewrelic added content requests related to docs site content from_tw Identifies issues/PRs from Tech Docs writers labels Apr 29, 2026
@sujitnewrelic
Copy link
Copy Markdown
Contributor Author

netlify build

sujitnewrelic and others added 3 commits April 29, 2026 11:37
Co-Authored-By: Claude <noreply@anthropic.com>
Resolve i18n rename/delete conflicts by keeping develop versions of
updated release note translation files.

Co-Authored-By: Claude <noreply@anthropic.com>
- Rename get-started page to overview of public sharing for both
  dashboards and charts; remove dashboard-only setup steps
- Move access management (policy enablement, roles, group setup) inline
  into share-dashboards-publicly and share-charts-publicly
- Replace detailed group-setup steps with reference to user-mgmt tutorial
- Delete standalone prerequisites-to-share-dashboards-charts page;
  redirect captured in get-started page frontmatter
- Remove security page from nav; update NerdGraph API doc links
- All permissions-to-custom-role links updated to #configure-roles anchor

Co-Authored-By: Claude <noreply@anthropic.com>
@github-actions
Copy link
Copy Markdown

[!NOTE]

Our Vale automated writing feedback tool has suggestions for this PR. You can view these suggestions in the Files changed tab. If you're not a New Relic docs writer, we'll review any comments and you don't need to take any action (though feel free to make edits if you like!).

sujitnewrelic and others added 5 commits April 29, 2026 13:18
Re-adds the pain-point/solution scenario from the original combined doc
(service disruption, real-time customer visibility) that was omitted
during the restructure. Also adds the password protection context note.

Co-Authored-By: Claude <noreply@anthropic.com>
Updates page title, nav entry, and all DocTile references.

Co-Authored-By: Claude <noreply@anthropic.com>
…lability callout

- Rename page title and nav entry to Introduction to public sharing
- Replace Availability inline text with original <Callout variant="important">
  covering both dashboard and chart availability in one note

Co-Authored-By: Claude <noreply@anthropic.com>
Covers interactive capabilities (time range, view mode, TV mode) for
both dashboards and charts in the intro page, as it applies to both.

Co-Authored-By: Claude <noreply@anthropic.com>
Now covered in the Introduction to public sharing page.

Co-Authored-By: Claude <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

content requests related to docs site content from_tw Identifies issues/PRs from Tech Docs writers

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants