Bug 1332713

Summary: Reorganize the Transition Guide
Product: Red Hat Satellite Reporter: Andrew Dahms <adahms>
Component: Docs Transition GuideAssignee: Stephen Wadeley <swadeley>
Status: CLOSED CURRENTRELEASE QA Contact: Andrew Dahms <adahms>
Severity: high Docs Contact:
Priority: high    
Version: 6.2.0CC: adahms, rjerrido
Target Milestone: Unspecified   
Target Release: Unused   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2016-07-14 18:30:31 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: 1285918, 1344318    
Bug Blocks:    

Description Andrew Dahms 2016-05-03 21:37:12 UTC
This bug is a tracker for work to reorganize the Transition Guide with the primary aim of clarifying the overall workflow and options, and promoting several items in the table of contents that cannot be seen due to nesting.

Comment 1 Andrew Dahms 2016-05-03 21:37:38 UTC
Assigning to Stephen for review.

Comment 4 Stephen Wadeley 2016-05-18 07:39:51 UTC
Andrew Dahms, seconded by myself, proposed to change the name:

Transition Guide → Migration Guide

Apart from the name being more suitable, there is also the benefit of consistency with other guides.

Rich Jerrido agreed to the name change.

Comment 5 Stephen Wadeley 2016-05-19 12:06:08 UTC
Hello

"~/.transition_data directory" vs. "~/.migration_data directory"

There is an admonition:

All import data is stored in CSV files in the ~/.migration_data directory. This information is critical for any subsequent data imports. Do not modify the data in this directory. 


My sed search and replace changed that from "~/.transition_data", but I wonder where that path comes from and if I need to change it back.

Comment 6 Rich Jerrido 2016-05-19 17:34:40 UTC
(In reply to Stephen Wadeley from comment #5)
> Hello
> 
> "~/.transition_data directory" vs. "~/.migration_data directory"
> 
> There is an admonition:
> 
> All import data is stored in CSV files in the ~/.migration_data directory.
> This information is critical for any subsequent data imports. Do not modify
> the data in this directory. 
> 
> 
> My sed search and replace changed that from "~/.transition_data", but I
> wonder where that path comes from and if I need to change it back.

that is where hammer_cli_import looks for it, if I remember correctly.

Comment 7 Stephen Wadeley 2016-05-20 08:57:35 UTC
Thank you Rich for comment 6

= = = = = = 

commit 5bb1f0a323416299a0384449e9ad88e5d15a8563
Author: Stephen Wadeley <swadeley>
Date:   Fri May 20 10:53:45 2016 +0200

    migration_data > transition_data
    
    https://bugzilla.redhat.com/show_bug.cgi?id=1332713#c6
    Bug 1332713 - Reorganize the Transition Guide

Comment 11 Stephen Wadeley 2016-06-08 12:21:02 UTC
(In reply to Stephen Wadeley from comment #4)
> Andrew Dahms, seconded by myself, proposed to change the name:
> 
> Transition Guide → Migration Guide
> 
> Apart from the name being more suitable, there is also the benefit of
> consistency with other guides.
> 
> Rich Jerrido agreed to the name change.

Change of plan, name change not going ahead to use of "Transition Guide" previously.

Comment 19 Andrew Dahms 2016-07-12 12:56:11 UTC
The requested changes have been implemented.

Moving to VERIFIED.

Comment 20 Stephen Wadeley 2016-07-14 18:30:31 UTC
Hello


the new version of guide has been published here:
https://access.redhat.com/documentation/en/red-hat-satellite/6.2/transition-guide/transition-guide