Re: [Tails-dev] Comments on Tails documentation

Delete this message

Reply to this message
Autor: sajolida
Data:  
Dla: The Tails public development discussion list
Temat: Re: [Tails-dev] Comments on Tails documentation
On 07/04/13 23:10, intrigeri wrote:
> Hi,
>
> sajolida@??? wrote (07 Apr 2013 20:25:12 GMT) :
>>> doc/first_steps/bug_reporting
>>> =============================
>>>
>>> describing screenshot content?
>>> ------------------------------
>>>
>>> under "Write the report", the 5 bullet points add nothing useful to
>>> the screenshot and can be removed (or moved to a "alt" attribute).
> [...]
>> Removed the screenshot in favor of the text with feeb3cb.
>
> Great, but the comment was about the text and screenshot under "Write
> the report". I guess this screenshot could go away too, then?


Ok, I just removed all of them with 3baf7a8.

>> If we cannot agree on an external resource to link about good password
>> practices I propose to create a ticket for that (ie. for finding a link,
>> not writing the doc).
>
> I've no such link in mind. Anyone?
>
>>> i find the use of bold text in the intro section to be distracting,
>>> though i understand the motivation. if used generally as a house
>>> style, i don't really object, but i don't recall that it is, and my
>>> personal reaction is that it is not a plus.
>
>> I use bold in text to make it scannable.
>> See http://www.nngroup.com/articles/how-users-read-on-the-web/.
>
>> But I agree that can also add distraction, and I'm surely not an expert
>> on that technique. I've already been using it, for example in:
>
>> https://tails.boum.org/doc/first_steps/persistence/warnings/
>> https://tails.boum.org/doc/about/fingerprint/
>
>> Do you feel the same issue affect those pages too?
>
> I'm just the messenger, so I suggest you ask velope on #tails :)
>
>> In the case of KeepassX, the three things in bold are three strong
>> arguments in favor of KeepassX. They could also be presented as a dotted
>> list. For example:
>> [...]
>> Would that be an improvement?
>
> Personally, I like it the way it currently is.
>
> To end with, I suggest you point velope @ #tails to the changes you
> made, and see if they're happy with them :)


Will do.