Skip to content

fix(onboarding): address gaps in onboarding docs - #314

Merged
akafazov merged 2 commits into
platform-mesh:mainfrom
akafazov:fix/305-organization-onboarding
Nov 12, 2026
Merged

akafazov merged 2 commits into
platform-mesh:mainfrom
akafazov:fix/305-organization-onboarding

Conversation

@akafazov

@akafazov akafazov commented Nov 11, 2026 •

Copy link
Copy Markdown
Contributor

Organization onboarding instructions did not clearly distinguish Keycloak admin credentials, the initial welcome user, and the organization user. This updates the guide to explain which realm and credentials to use at each step.

  • Adds a login-context table and onboarding flow diagram.
  • Documents initial-user creation, email verification, and password setup.
  • Clarifies that the organization user needs a separately configured password and must be edited in the organization’s realm.
  • Warns that the local portal’s advertised default password is incorrect.

Refs #305.

Validation: documentation reviewed; production onboarding verification remains blocked by DNS record conflicts.

Signed-off-by: Angel Kafazov <akafazov@cst-bg.net>
@akafazov
akafazov force-pushed the fix/305-organization-onboarding branch from 37897b5 to 0effc44 Compare November 11, 2026 14:06
@akafazov
akafazov marked this pull request as ready for review November 11, 2026 14:08
@akafazov
akafazov requested review from a team as code owners November 11, 2026 14:08
ntnn
ntnn previously approved these changes Nov 11, 2026
Comment on lines +94 to +98
::: warning Incorrect password in the local portal popup
The local portal's success popup says the default password is `password`.
This message is incorrect: the organization user has no password set yet.
Before clicking **Switch**, complete the password setup in step 3 below.
:::

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do we have a ticket tracking this?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actually after double-checking this has been removed. I updated the text accordingly.

Signed-off-by: Angel Kafazov <akafazov@cst-bg.net>
@akafazov
akafazov force-pushed the fix/305-organization-onboarding branch from 249868e to e01ec6f Compare November 12, 2026 08:23
@akafazov
akafazov enabled auto-merge (squash) November 12, 2026 08:24
@akafazov
akafazov requested a review from ntnn November 12, 2026 08:24
@akafazov
akafazov merged commit cb1ac99 into platform-mesh:main Nov 12, 2026
5 checks passed
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.

2 participants