Bug 2172613

Summary: Wrong hammer command in "8.3. Setting the Location Context" of Administration guide of Satellite 6.13
Product: Red Hat Satellite Reporter: Sayan Das <saydas>
Component: DocumentationAssignee: Adam Lazik <alazik>
Documentation sub component: default QA Contact:
Status: CLOSED CURRENTRELEASE Docs Contact:
Severity: medium    
Priority: unspecified CC: alazik
Version: 6.13.0Keywords: Triaged
Target Milestone: Unspecified   
Target Release: Unused   
Hardware: All   
OS: All   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2023-05-03 20:46:33 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 Sayan Das 2023-02-22 17:48:27 UTC 
Document URL: 

https://dxp-docp-prod.apps.ext-waf.spoke.prod.us-west-2.aws.paas.redhat.com/documentation/en-us/red_hat_satellite/6.13/html-single/administering_red_hat_satellite/index?lb_target=preview

Section Number and Name: 

8.3. Setting the Location Context

Describe the issue: 

We mention this i.e. 

~~
# hammer subscription list \
--location "My_Location"
This command outputs subscriptions allocated for the My_Location.
~~

The command is wrong and so as the statement.

Prove:
~~
# hammer subscription list --location GSS
Error: Unrecognised option '--location'.

See: 'hammer subscription <list|index> --help'.
~~


Suggestions for improvement: 

Make the command:
~~
hammer host list --location "My_Location"
~~

And the text:
~~
This command lists hosts associated with the "My_Location" location.
~~

Or something more appropriate 


Additional information: 

NA
Comment 1 Adam Lazik 2023-02-23 12:44:12 UTC 
Hello!

Created PR:  https://github.com/theforeman/foreman-documentation/pull/2021
Comment 2 Adam Lazik 2023-02-27 17:54:42 UTC 
The documentation has been updated:
https://dxp-docp-prod.apps.ext-waf.spoke.prod.us-west-2.aws.paas.redhat.com/documentation/en-us/red_hat_satellite/6.13/html-single/administering_red_hat_satellite/index?lb_target=preview#Setting_the_Location_Context_admin
Comment 3 Marie Hornickova 2023-05-03 20:46:33 UTC 
Updated documentation is now live on Red Hat Customer Portal:

https://access.redhat.com/documentation/en-us/red_hat_satellite/6.13/html-single/administering_red_hat_satellite/index#Setting_the_Location_Context_admin