Skip to content

docs: add "Find your identifiers and settings" orientation reference#820

Open
ekline[bot] wants to merge 1 commit into
mainfrom
docs/find-identifiers-and-settings
Open

docs: add "Find your identifiers and settings" orientation reference#820
ekline[bot] wants to merge 1 commit into
mainfrom
docs/find-identifiers-and-settings

Conversation

@ekline

@ekline ekline Bot commented Jul 1, 2026

Copy link
Copy Markdown
Contributor

Problem

Developers during setup repeatedly ask support "where do I find / configure X?" in the Scalekit dashboard. The facts exist but are scattered across quickstarts and guides (and dashboard paths are stated inconsistently across pages), so there is no single findable orientation reference. This is a discoverability / information-architecture gap, not a missing feature.

Audience

A developer during setup/configuration, beginner-to-intermediate, trying to locate an identifier or a setting in the dashboard.

Gravity

MEDIUM. 3-4 distinct customers, every case resolved in minutes once support named the exact dashboard path. The fast resolutions are the signature of a discoverability gap.

Verdict

B (covered but buried/unfindable). Scattered facts, no single orientation reference.

Scrubbed customer quotes

  • "SCALEKIT_RESOURCE_ID => where can I find this? what to fill?"
  • "there is add mcp server option in your dashboard but i don't see that option now"
  • "It seems we cannot add a footer to the login page"

Fix

Add one concise, table-driven reference page, Find your identifiers and settings, that maps each identifier and setting to its exact dashboard path:

  • Environment URL, client ID, client secret -> Settings > API credentials
  • Resource id (res_...) -> MCP Servers > your server > Configuration
  • Login page footer / ToS / privacy links -> Settings > Application details
  • Enabled SSO connections -> Authentication > Auth methods > Enterprise SSO
  • Add MCP server option -> visible only when the module selector is set to Auth for SaaS
  • Access token claims -> access token template API (self-serve dashboard portal described as forthcoming)

The page cross-links to existing docs with root-relative links instead of restating them, and is wired into the Resources > Platform sidebar section alongside the other reference pages. No secondary-nav change is needed because the page lives under /reference/ (already mapped to the resources topic) and joins an existing sidebar id.

Follow-ups

  • Document the access-token-claims self-serve dashboard portal once it ships (replace the "planned" note with the exact path).
  • Consider linking this orientation page from the FSA, MCP, and AgentKit quickstarts so developers find it earlier in the journey.
  • Reconcile the inconsistent "API credentials" dashboard paths stated across existing pages (set-up-scalekit vs environments) against this canonical reference.

Preview

https://deploy-preview-{PR_NUMBER}--scalekit-starlight.netlify.app/reference/find-identifiers-and-settings/


📝 Created with EkLine · View session

@netlify

netlify Bot commented Jul 1, 2026

Copy link
Copy Markdown

Deploy Preview for scalekit-starlight ready!

Name Link
🔨 Latest commit 9c0821a
🔍 Latest deploy log https://app.netlify.com/projects/scalekit-starlight/deploys/6a455584d9274500088665f6
😎 Deploy Preview https://deploy-preview-820--scalekit-starlight.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: 57 (🟢 up 19 from production)
Accessibility: 98 (no change from production)
Best Practices: 92 (no change from production)
SEO: 92 (no change from production)
PWA: -
View the detailed breakdown and full score reports
🤖 Make changes Run an agent on this branch

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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants