Bug 1295600

Summary:	[Docs] [Provisioning] Check syntax and links
Product:	Red Hat CloudForms Management Engine	Reporter:	Andrew Dahms <adahms>
Component:	Documentation	Assignee:	Red Hat CloudForms Documentation <cloudforms-docs>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Dayle Parker <dayleparker>
Severity:	medium	Docs Contact:
Priority:	medium
Version:	5.5.0	CC:	adahms, dayleparker, jhardy, lbopf, mfeifer, obarenbo
Target Milestone:	GA
Target Release:	5.5.2
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:	doc
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2016-05-09 07:17:50 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:
Bug Depends On:
Bug Blocks:	1289516

Description Andrew Dahms 2016-01-05 00:52:40 UTC

The Provisioning Virtual Machines and Hosts guide must be reviewed to standardize use of AsciiDoc syntax and to update links to other guides in the Red Hat CloudForms documentation suite.

This includes the following items -

* Remove any procedure titles
* Remove any 'Result::' blocks
* Use 'btn:[Button Name]' for buttons
* Use +Text+ for labels and replaceables
* Ensure delimiters (e.g. ======) are six characters long
* Update links to other guides in the suite to use the correct title and
  section name

Comment 1 Shikha 2016-02-26 01:39:07 UTC

Hi Andrew,
I have reviewed and updated the syntax for Provisioning Virtual Machines and Hosts guide.
Following edits have been made:

* Remove any procedure titles
* Remove any 'Result::' blocks
* Use ** for buttons, labels, and replaceables
* Use `` for literals
* Ensure delimiters (e.g. ======) are six characters long
* Use menu tags wherever applicable
* Update links to other guides in the suite to use the correct title and
  section name

Please assign a QE to review the following changes and merge request:

Merge request: https://gitlab.cee.redhat.com/rhci-documentation/docs-Red_Hat_CloudForms/merge_requests/127

Regards,
Shikha

Comment 2 Shikha 2016-03-31 06:31:05 UTC

Hi Dayle,
Please review the following merge request:
Merge request: https://gitlab.cee.redhat.com/rhci-documentation/docs-Red_Hat_CloudForms/merge_requests/127
Regards,
Shikha

Comment 3 Lucy Bopf 2016-04-01 01:40:22 UTC

Hi Shikha,

Thank you for the update! I have taken a look at the merge request, corrected some minor rendering errors, and merged the changes into master.

Moving this bug to VERIFIED.

Comment 5 Lucy Bopf 2016-05-09 07:17:50 UTC

The updated documentation is available at the following location:

https://access.redhat.com/documentation/en/red-hat-cloudforms/version-4.0/provisioning-virtual-machines-and-hosts/

Closing.