Bug 33240 – Shares: Mixed up paragraph placement

Bug 33240 - Shares: Mixed up paragraph placement


Summary:	Shares: Mixed up paragraph placement

Status:	CLOSED FIXED

Product:	UCS manual
Classification:	Unclassified
Component:	Shares
Version:	unspecified
Hardware:	Other Linux

Importance:	P5 normal (vote)
Target Milestone:	UCS 3.2
Assigned To:	Moritz Muehlenhoff
QA Contact:	Erik Damrose

URL:
Keywords:

Depends on:
Blocks:
	Show dependency tree / graph

Reported:	2013-11-11 12:56 CET by Erik Damrose
Modified:	2015-04-01 13:48 CEST (History)
CC List:	1 user (show)

See Also:
What kind of report is it?:	---
What type of bug is this?:	---
Who will be affected by this bug?:	---
How will those affected feel about the bug?:	---
User Pain:
Enterprise Customer affected?:
School Customer affected?:
ISV affected?:
Waiting Support:
Flags outvoted (downgraded) after PO Review:
Ticket number:
Bug group (optional):
Max CVSS v3 score:

Attachments
Add an attachment (proposed patch, testcase, etc.)

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

Description Erik Damrose

2013-11-11 12:56:02 CET

In the ucs 3.2-doc permissions section the paragraph ordering differs between the german and english version

<section id="shares::permissions">:
DE: <para>
        Jede Datei/Verzeichnis wird von einem Benutzer und einer Gruppe besessen. Die
        drei oben genannten Rechte können jeweils auf den Besitzer, die
        Besitzer-Gruppe und alle anderen angewendet werden.
  </para>

EN: <para>
        Each file/directory is owned by a user and a group. The three
        permission outlined above can be applied to the user owner, the owner group
        and all others.
  </para>

The paragraph is placed above the explanation about setuid/setgid/sticky bit for the german manual, but below the explanation in the english manual. As the paragraph is about "three permissions outlined above" this is confusing the reader. I think the german version is correct.

Comment 1 Moritz Muehlenhoff

2013-11-11 13:09:15 CET

Fixed in revision 45938

Comment 2 Erik Damrose

2013-11-11 16:03:27 CET

I think putting the paragraph directly below the description of read/write/execute is better. The current version is confusing the (inexperienced) reader: first the access rights rwx are explained, then setuid/setgid/sticky bit are introduced, followed by the (now disputed) paragraph, which talks about 'the three permissions mentioned above. The reader may confuse it with the setuid/setgid/sticky bit part.

Proposed order: rwx explanation, the summarizing paragraph, then setuid/setgid/sticky bit.

Comment 3 Moritz Muehlenhoff

2013-11-12 09:36:13 CET

Fixed in revision 45951

Comment 4 Erik Damrose

2013-11-12 10:11:24 CET

Verified