Skip to content

docs: Saved views for inventory record/artifact fields#1369

Open
validbeck wants to merge 17 commits into
mainfrom
beck/sc-15704/documentation-organization-saved-views-for
Open

docs: Saved views for inventory record/artifact fields#1369
validbeck wants to merge 17 commits into
mainfrom
beck/sc-15704/documentation-organization-saved-views-for

Conversation

@validbeck

@validbeck validbeck commented Jun 11, 2026

Copy link
Copy Markdown
Collaborator

Pull Request Description

What and why?

sc-15704

You can save and share layouts for inventory record and artifact fields. Documentation updated to support this functionality.

How to test

Click on the live previews and confirm that the changes are good/accurate:

OLD NEW Changes
Customize record overview page Customize record overview page Net-new section: "Manage record field layouts"
Customize artifact overview page Customize artifact overview page Net-new section: "Manage artifact field layouts"

What needs special review?

n/a

Dependencies, breaking changes, and deployment notes

n/a

Release notes

Covered by:

Checklist

  • What and why
  • Screenshots or videos (Frontend)
  • How to test
  • What needs special review
  • Dependencies, breaking changes, and deployment notes
  • Labels applied
  • PR linked to Shortcut
  • Unit tests added (Backend)
  • Tested locally
  • Documentation updated (if required)
  • Environment variable additions/changes documented (if required)

@validbeck validbeck self-assigned this Jun 11, 2026
@validbeck validbeck added the internal Not to be externalized in the release notes label Jun 11, 2026

@jamadriz jamadriz left a comment

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.

One blocking typo in _personal-field-views.qmd — see inline comment.

Comment thread site/guide/shared/manage-views/_personal-field-views.qmd

@jamadriz jamadriz left a comment

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.

Additional frontend alignment notes from implementation review (ManagePageLayoutViewsButton, EditPageLayoutModal, src/copy/base.en.ts).

Comment thread site/guide/inventory/customize-record-overview-page.qmd Outdated
Comment thread site/guide/validation/customize-artifact-overview-page.qmd
Comment thread site/guide/inventory/customize-record-overview-page.qmd
Comment thread site/guide/validation/customize-artifact-overview-page.qmd
Comment thread site/guide/shared/manage-views/_organization-field-views.qmd
Comment thread site/guide/shared/manage-views/_organization-field-views.qmd
Comment thread site/guide/shared/manage-views/_organization-field-views.qmd Outdated
Comment thread site/guide/shared/manage-views/_personal-field-views.qmd Outdated
Comment thread site/guide/shared/manage-views/_personal-field-views.qmd Outdated
@validbeck validbeck requested a review from jamadriz June 12, 2026 20:29

@jamadriz jamadriz left a comment

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.

👌🏼

@github-actions

Copy link
Copy Markdown
Contributor

PR Summary

This pull request focuses on refining the textual labels and the inclusion logic within our documentation regarding user profiles, inventory, artifact layouts, and workflow views. Key changes include:

  • Updating UI labels such as changing 'See my profile' to 'View my Profile'.
  • Replacing generic partial includes (e.g., _personal-views.qmd and _organization-views.qmd) with more descriptive table and field view includes (e.g., _personal-table-views.qmd, _organization-table-views.qmd, _personal-field-views.qmd, and _organization-field-views.qmd).
  • Introducing a new section for managing record field layouts which guides users on how to save and manage custom layouts for inventory records, complete with local session save notes.
  • Enhancing sections in both inventory and artifact layout pages by renaming menu options (e.g., updating 'Change fields display' to 'Change Field Configuration') and adding context such as session storage details.
  • Updating reference footnotes to correctly point to the new sections and improves consistency across the documentation.
  • Supplementing new callout panels in shared view documentation to explain organizational view sharing, unpublishing, deleting, and editing workflows.

These changes aim to improve clarity and user experience by providing consistent and descriptive labels along with proper instructional flows in the documentation.

Test Suggestions

  • Verify that all updated UI labels are correctly rendered in the documentation pages, especially the changes from 'See my profile' to 'View my Profile'.
  • Check that the new includes (e.g., _personal-table-views.qmd, _organization-table-views.qmd) are correctly referenced and loaded in all relevant pages for inventory, artifact, and workflow views.
  • Test navigation through the inventory and artifact configuration pages to ensure that all callouts, footnotes, and layout management sections correctly link to the new sections.
  • Review the session storage note to confirm that instructions regarding local layout saving are clear and properly formatted.

@github-actions

Copy link
Copy Markdown
Contributor

Validate docs site

✓ INFO: A live preview of the docs site is available — Open the preview

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

Labels

internal Not to be externalized in the release notes

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants