Bug 2235639

Summary:	[Docs] No documentation about custom deprecated VM templates after an upgrade
Product:	Container Native Virtualization (CNV)	Reporter:	Juan Orti <jortialc>
Component:	Documentation	Assignee:	Audrey Spaulding <aspauldi>
Status:	CLOSED NEXTRELEASE	QA Contact:	Oded Ramraz <oramraz>
Severity:	high	Docs Contact:
Priority:	unspecified
Version:	4.12.0	CC:	ctomasko, dholler
Target Milestone:	---
Target Release:	4.15.0
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	If docs needed, set a value
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2023-10-30 13:46:09 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:

Description Juan Orti 2023-08-29 11:23:17 UTC

Document URL:

https://access.redhat.com/documentation/en-us/openshift_container_platform/4.12/html/virtualization/virtual-machine-templates
https://access.redhat.com/documentation/en-us/openshift_container_platform/4.12/html/virtualization/virt-4-12-release-notes#virt-4-12-new

Section Number and Name: 

"5.3. New and changed features" and "Chapter 11. Virtual machine templates"

Describe the issue: 

After a EUS-to-EUS upgrade from 4.10 to 4.12, all VM templates are marked as deprecated. Documentation is lacking in several ways:

- No warning about this on changed/deprecated features.
- There's no details about what exactly has to be changed to adapt the templates to the new format.
- There's no reference of what is the correct format.

Suggestions for improvement:

- Document the accepted template format.
- Document the template format changes from version to version.
- Warn in the changelog of the format deprecations.

Additional information:

Comment 4 Avital Pinnick 2023-09-05 09:50:34 UTC

A Jira task has been created for this bug (linked above). Targeted for 4.15.

Comment 5 ctomasko 2023-10-30 13:25:21 UTC

Duplicate of https://issues.redhat.com/browse/CNV-32614

Comment 6 ctomasko 2023-10-30 13:46:09 UTC

Closed, duplicate of https://issues.redhat.com/browse/CNV-32614