Bug 1597390 - [RFE] Description of public key based authorization seems to be missing a phrase
Summary: [RFE] Description of public key based authorization seems to be missing a phrase
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Gluster Storage
Classification: Red Hat Storage
Component: doc-Deploying_RHHI
Version: rhhi-1.1
Hardware: x86_64
OS: Linux
unspecified
low
Target Milestone: ---
: RHHI-V 1.5
Assignee: storage-doc
QA Contact: bipin
URL:
Whiteboard:
Depends On:
Blocks: 1724792 1534399
TreeView+ depends on / blocked
 
Reported: 2018-07-02 20:23 UTC by Adam Scerra
Modified: 2019-06-28 16:04 UTC (History)
7 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2018-12-17 09:32:29 UTC
Embargoed:


Attachments (Terms of Use)

Description Adam Scerra 2018-07-02 20:23:45 UTC
Description of problem:
Doc link: https://access.redhat.com/documentation/en-us/red_hat_hyperconverged_infrastructure/1.1/html/deploying_red_hat_hyperconverged_infrastructure/task-configure-key-based-ssh-auth

This section gives a description of public key based ssh authentication.
The phrase 'passwordless' is never used here in the description. It seems that this description could benefit with the use added use of this phrase.

Add phrase "passwordless ssh" somewhere in here. EX. "Doing this will enable passwordless ssh between the hosts" This phrase is used in addition to "Public Key authentication based SSH" and wouldn't hurt to include both.

Version-Release number of selected component (if applicable):
rhhi 1.1

How reproducible:
always

Steps to Reproduce:
1.Go to link above

Actual results:
The phrase 'passwordless' is never used here in the description.

Expected results:
Acknowledge that this will setup passwordless ssh or has the abillity to setup passwordless ssh.

Additional info:

Comment 2 Laura Bailey 2018-07-06 03:25:04 UTC
This was rewritten explicitly to remove "passwordless" since it's a) not used as often as 'key-based' or 'without a password' and b) harder to translate since it isn't actually a word.

We can be more specific about the point being to configure SSH using keys without a passphrase, but passwordless itself is probably not a good idea except as an "also known as" definition.

Would appreciate your thoughts here Adam.

Comment 3 Adam Scerra 2018-07-09 13:56:22 UTC
I do understand the careful use of the non word "passwordless". I believe 'without a password' works just fine, I feel that the point of configuring these keys gets slightly lost in translation. The words 'without a password' would ensure the user knows exactly why they are doing what they are doing.


Note You need to log in before you can comment on or make changes to this bug.