Skip to content

Optimize (CQA) - Mng content - Managing CVs#4897

Draft
Lennonka wants to merge 4 commits into
theforeman:masterfrom
Lennonka:premig-mng-content-CVs-rewrites
Draft

Optimize (CQA) - Mng content - Managing CVs#4897
Lennonka wants to merge 4 commits into
theforeman:masterfrom
Lennonka:premig-mng-content-CVs-rewrites

Conversation

@Lennonka

@Lennonka Lennonka commented Jun 3, 2026

Copy link
Copy Markdown
Contributor

What changes are you introducing?

Optimizing headings, abstracts, and prerequisites of the Managing content views chapter in Managing content

Why are you introducing these changes? (Explanation, links to references, issues, etc.)

  • Headings must be appropriate and of the length 3-11 words
  • Abstracts must be optimized for SEO and GEO
  • Prerequisites must not use imperative

Anything else to add? (Considerations, potential downsides, alternative solutions you have explored, etc.)

  • New prerequisites might require tech ack.

Contributor checklists

  • I am okay with my commits getting squashed when you merge this PR.
  • I am familiar with the contributing guidelines.

Please cherry-pick my commits into:

  • Foreman 3.19/Katello 4.21
  • Foreman 3.18/Katello 4.20 (Satellite 6.19)
  • Foreman 3.17/Katello 4.19
  • Foreman 3.16/Katello 4.18 (Satellite 6.18; orcharhino 7.6, 7.7, and 7.8)
  • Foreman 3.15/Katello 4.17
  • Foreman 3.14/Katello 4.16 (Satellite 6.17; orcharhino 7.4; orcharhino 7.5)
  • Foreman 3.13/Katello 4.15 (EL9 only)
  • Foreman 3.12/Katello 4.14 (Satellite 6.16; orcharhino 7.2 on EL9 only; orcharhino 7.3)
  • We do not accept PRs for Foreman older than 3.12.

@github-actions github-actions Bot added Needs tech review Requires a review from the technical perspective Needs style review Requires a review from docs style/grammar perspective Needs testing Requires functional testing labels Jun 3, 2026
@Lennonka Lennonka removed the Needs testing Requires functional testing label Jun 3, 2026
@Lennonka

Lennonka commented Jun 3, 2026

Copy link
Copy Markdown
Contributor Author

@ianballou @jeremylenz Can you, please, review the new prerequisites for technical accuracy?

@github-actions

github-actions Bot commented Jun 3, 2026

Copy link
Copy Markdown

For example, you might have separate content views to manage an operating system and an application individually.
You can use a composite content view to merge the contents of both content views into a new repository.
The repositories for the original content views still exist but a new repository also exists for the combined content.
A composite content view merges repositories from several content views into one host-facing repository.

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.

Similar to what I wrote in #4895 (comment).

Comment thread guides/common/modules/con_content-filter-examples.adoc

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.

non-blocking: I have no suggestion for this module, but it's a bit unclear to me based on the title.

Based on the abstract, it's almost a procedure with steps that users follow when starting to create CV filters.

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.

I do have a suggestion - see #4895 (comment)

Comment thread guides/common/modules/con_rolling-content-views.adoc Outdated
Comment thread guides/common/modules/proc_copying-a-content-view-by-using-cli.adoc Outdated
Comment thread guides/common/modules/proc_creating-a-content-view-filter-by-using-web-ui.adoc Outdated
Comment thread guides/common/modules/proc_creating-a-rolling-content-view-by-using-cli.adoc Outdated
Comment thread guides/common/modules/proc_creating-a-rolling-content-view-by-using-web-ui.adoc Outdated
Comment thread guides/common/modules/proc_viewing-module-streams-by-using-cli.adoc Outdated
Comment thread guides/common/modules/proc_viewing-module-streams-by-using-web-ui.adoc Outdated
@Lennonka Lennonka mentioned this pull request Jun 3, 2026
10 tasks
@Lennonka Lennonka marked this pull request as draft June 3, 2026 21:14
Lennonka added 3 commits June 4, 2026 01:17
Assisted-by: Cursor
Assisted-by: Cursor
Assisted-by: Cursor
@Lennonka Lennonka force-pushed the premig-mng-content-CVs-rewrites branch from e1e2d64 to 646e430 Compare June 3, 2026 23:17
@Lennonka

Lennonka commented Jun 3, 2026

Copy link
Copy Markdown
Contributor Author

Rebased.

Co-authored-by: Maximilian Kolb <mail@maximilian-kolb.de>
Co-authored-by: Lena Ansorge <zuansorg@redhat.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Needs style review Requires a review from docs style/grammar perspective Needs tech review Requires a review from the technical perspective

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants