Skip to content

Conversation

@crudo
Copy link

@crudo crudo commented Dec 3, 2025

This pull request updates the documentation for user roles in Hybrid Manager to standardize and clarify the naming of roles. The changes improve consistency and readability by using title case for all role names and aligning them with their functional descriptions.

Documentation updates for user roles:

  • Standardized all role names to title case (e.g., "Organization administrator" → "Organization Administrator", "Project owner" → "Project Owner") for consistency and clarity.
  • Updated some role names to better reflect their functions, such as changing "GenAI Builder user" to "GenAI Builder Editor".
  • Applied these naming conventions to both organization-level and project-level roles throughout the documentation.

See https://github.com/EnterpriseDB/upm-beaco-ff-base/pull/443

Role ID Old name New name
rol_org_appliance_admin platform admin Platform Administrator
rol_org_owner owner Organization Owner
rol_org_admin admin Organization Administrator
rol_prj_catalog_data_reader catalog data reader Catalog Data Reader
rol_prj_catalog_data_writer catalog data writer Catalog Data Writer
rol_prj_migration_portal_projects_editor Migration Portal projects editor Migration Portal Projects Editor
rol_prj_migration_portal_projects_owner Migration Portal projects owner Migration Portal Projects Owner
rol_prj_migration_portal_projects_viewer Migration Portal projects viewer Migration Portal Projects Viewer
rol_prj_owner owner Project Owner
rol_prj_editor editor Project Editor
rol_prj_viewer viewer Project Viewer
rol_prj_pipeline_editor Pipeline editor Pipeline Editor
rol_org_genai_builder_user GenAI Builder user GenAI Builder Editor
rol_prj_estate_ingester estate ingester Estate Ingester

@crudo crudo requested a review from a team as a code owner December 3, 2025 11:48
### Estate ingester (estate ingester)
### Estate Ingester

This role is for machine users and provides access to perform estate ingests in a project.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
This role is for machine users and provides access to perform estate ingests in a project.
This role is for machine-users and provides access to perform estate ingests in a project.

This is how it's written earlier and I believe this is meant if you're referring to a non-human user.

### Project viewer (viewer)
### Project Viewer

For users who only need to observe the data in a project, the project viewer role provides data read-only access.
Copy link
Contributor

@ebgitelman ebgitelman Dec 12, 2025

Choose a reason for hiding this comment

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

Suggested change
For users who only need to observe the data in a project, the project viewer role provides data read-only access.
For users who only need to observe the data in a project, the Project Viewer role provides read-only access.


This role is for users who need to actively work with the data in a project.
This role is for users who need to actively work with the data in a project.
Project editors have data read and write access.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
Project editors have data read and write access.
Users with the Project Editor role have read and write access to data.

### Project Owner

In a specific project, the project owner has the highest level of authority.
In a specific project, the project owner has the highest level of authority.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
In a specific project, the project owner has the highest level of authority.
In a specific project, the Project Owner role has the highest level of authority.


## Project-level roles

These roles can be assigned to human or machine users (except for estate ingester). Select **Users** in the left navigation when viewing a project.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
These roles can be assigned to human or machine users (except for estate ingester). Select **Users** in the left navigation when viewing a project.
These roles can be assigned to human or machine-users (except for Estate Ingester). Select **Users** in the left navigation when viewing a project.


## Organization-level roles

You can assign these roles to human or machine users using the **User Management** option of your user profile menu at the top-right of the navigation bar in the HM console.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
You can assign these roles to human or machine users using the **User Management** option of your user profile menu at the top-right of the navigation bar in the HM console.
You can assign these roles to human or machine-users using the **User Management** option of your user profile menu at the top-right of the navigation bar in the HM console.


### Estate ingester (estate ingester)

This role is for machine users and provides access to perform estate ingests in a project.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
This role is for machine users and provides access to perform estate ingests in a project.
This role is for machine-users and provides access to perform estate ingests in a project.


These roles can be assigned to human or machine users (except for estate ingester). Select **Users** in the left navigation when viewing a project.

### Project owner (owner)
Copy link
Contributor

Choose a reason for hiding this comment

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

Were these not meant to be changed as per the Preview doc below?

Users with this role can read the Iceberg namespace/table/view of project-scoped catalogs.

### Catalog data writer (catalog data writer)
### Catalog Data data writer (catalog data writer)
Copy link
Contributor

Choose a reason for hiding this comment

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

Is this correct?

This role is for machine users and provides access to perform estate ingests in a project.

### Catalog data reader (catalog data reader)
### Catalog Data data reader (catalog data reader)
Copy link
Contributor

Choose a reason for hiding this comment

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

Correct?

Copy link
Contributor

@ebgitelman ebgitelman left a comment

Choose a reason for hiding this comment

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

Puzzled that the names of roles weren't changed in the 1.2 doc?

@mpfuster mpfuster added the deploy Add this label to a PR and it will automatically be deployed to netlify label Dec 15, 2025
@github-actions
Copy link
Contributor

@github-actions github-actions bot temporarily deployed to pull request December 15, 2025 09:44 Inactive
@irmabenitezzapata-creator
Copy link
Contributor

Hi @crudo, @xugy99 do these changes also apply for 1.3?

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

Labels

deploy Add this label to a PR and it will automatically be deployed to netlify

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants