Repository navigation
docs: simplify the customer setup walkthrough - #41
Merged
Hou (SciencePotato) merged 6 commits intoOct 12, 2026
Conversation
Make the main guide a provider-neutral five-step setup path and keep detailed configuration in reference guides. Clarify current credential-cache behavior and keep portal screenshots pending authenticated capture. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 2cf2ccfa-2cb4-4843-b2eb-8809ca3cef9e
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Clarify the screenshot scope, setup input names and prompt order, and the local C# build during plan preview. Remove repeated customer instructions while retaining safety gates and the existing README formatting edit. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: 2cf2ccfa-2cb4-4843-b2eb-8809ca3cef9e
Hou (SciencePotato)
marked this pull request as ready for review
October 12, 2026 16:41
siyixian
approved these changes
Oct 12, 2026
Hou (SciencePotato)
deleted the
houchichan-microsoft-simpler-illustrated-onboarding
branch
October 12, 2026 17:04
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Make customer onboarding easier to follow, with five illustrated steps: get ready, register the application, run guided setup, connect and test the provider, then activate and hand over.
Documentation and images only; no runtime or infrastructure code changes.
Illustrations and their limits
The 12 screenshots cover app registration and IDs, script inputs and choices, an existing resource group, Function authentication, monitoring navigation and a Logs query, sample Security Store offers, and Key Vault credential entry. Identifying details are cropped or permanently covered in the image pixels. Named provider examples stay in the detailed onboarding guide, not the main README.
The original script capture used source
48b94a3d42e74ef2a1a65a286a7f8e24a53353ff. It collected inputs but stopped at prerequisite checks because the required Microsoft Graph context was not established. The approval prompt was not reached. A dedicated application registration was created, but no Azure hosting resources were deployed, no authentication policy was activated, and no provider messages were sent during that walkthrough.Other portal views show an existing nonproduction deployment. The registration-form screenshot was not submitted; the Key Vault form used a fake masked value and was cancelled without saving. The Logs result shows stored telemetry counts, not evidence of recipient delivery or a new deployment.
The owner has deferred full deployment-plan, progress, and completion captures. The included sample images satisfy the agreed illustration scope; they do not claim a completed end-to-end deployment.
Editorial review
Three sequential passes completed on the latest PR:
-ApplicationIdand-TenantIdto the portal fields, used the actual platform and Tenant scope prompt labels, corrected the input-screen caption, and explained that a plan preview can build the C# package locally before approval. Checked authentication, cache settings, and activation boundaries against current source.The existing README table-formatting edit is preserved. Current
mainis already an ancestor of this branch; no conflict resolution or base merge was needed.Verification
git diff --checkpasses. Runtime and infrastructure code are unchanged.Ready for review after the editorial checks. This does not authorize merging or claim end-to-end deployment or recipient delivery.