Skip to content

fix(config_guide): standardize field types, fix role groups and module reference#137

Open
emjay0921 wants to merge 1 commit intov2-in-progress-3from
fix/config-guide-828-studio-tools
Open

fix(config_guide): standardize field types, fix role groups and module reference#137
emjay0921 wants to merge 1 commit intov2-in-progress-3from
fix/config-guide-828-studio-tools

Conversation

@emjay0921
Copy link
Copy Markdown
Contributor

Why is this change needed?

QA review found field type naming inconsistencies across Studio docs and incomplete role group definitions in predefined roles.

How was the change implemented?

  • Standardized field type names to "Whole Number" and "Decimal Number" across event_data/field_definitions.md and studio/registry_field_builder.md (was inconsistent: "Integer", "Number (whole)", etc.)
  • Added notes to 4 predefined roles (Global Finance, Program Manager, Support, Support Manager) that ship with only base.group_user, explaining administrators should add deployment-specific groups
  • Fixed case management module reference from spp_case_management to spp_case_base in role_configuration/creating_roles.md

Related links

https://projects.acn.fr/projects/acn-eng/work_packages/828

…module reference

- Standardize field type names across Studio docs to "Whole Number" and
  "Decimal Number" (was inconsistent: "Integer", "Number (whole)", etc.)
- Add notes to predefined roles that ship with only base.group_user
  (Global Finance, Program Manager, Support, Support Manager) explaining
  they need deployment-specific groups added
- Fix case management module reference: spp_case_base (not spp_case_management)
@sonarqubecloud
Copy link
Copy Markdown

Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

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

Code Review

This pull request standardizes field type terminology across the documentation by renaming 'Integer' and 'Decimal' to 'Whole Number' and 'Decimal Number'. It also updates a specific implied group name for the Case Manager role and adds explanatory notes to several predefined global roles to clarify that they only provide basic internal access by default. Review feedback highlights the need to ensure consistency in document headers and comparison tables where the old terminology or conflicting access descriptions may still reside.

#### Range validation (numbers and dates)

**For Integer/Decimal fields:**
**For Whole Number/Decimal Number fields:**
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

medium

While the field names have been updated to "Whole Number" and "Decimal Number", the section header at line 90 (outside this diff hunk) still refers to "decimal/integer". To maintain consistency throughout the document, please ensure that all references, including headers, are updated to match the new standardized terminology.

- `base.group_user` (Internal User)

```{note}
This role ships with basic internal user access only. Your administrator should add deployment-specific program groups (e.g., program viewer, program officer) based on your organization's requirements.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

medium

The note for the Global Program Manager role correctly identifies that it ships with only basic access. However, the comparison table at the end of this file (lines 162-172) still lists this role as having "Full" access to Programs. This could be misleading for administrators. Consider adding a footnote to the table or clarifying that "Full" access is contingent on adding the deployment-specific groups mentioned in this note.

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.

1 participant