Re: [lp-br-sp] Curso de GNU/Linux para os alunos ingressantes da Unicamp 2015 - Cheatsheet

[Sergio Durigan Junior]

On Sunday, February 22 2015, Gabriel Krisman Bertazi wrote:

> Raniere Silva <address@hidden> writes:
>
>> O Gabriel avisou sobre um cheatsheet
>> que ele estava escrevendo para os ingressantes:
>> http://krisman.be/misc/reference_card.pdf.
>
> Hehe.
>
> Era uma versão preliminar, por isso só mandei no canal para discutir
> sugestões rápidas e ainda nem versionei os fontes! Depois ia vir para a
> lista.  Mas vamos lá :)

Eu imaginei que você fosse comentar depois, mesmo :-).  Mas enfim, já
que a thread foi iniciada...

A primeira coisa que eu notei é que o Cheat Sheet está em inglês.  Acho
que uma versão em pt_BR seria mais indicada pra entregar pros bixos.
IOW, acho legal *também* ter uma versão em pt_BR, além da versão em
en_US.

>> Minhas sugestões:
>>
>> -   Deixar claro a notação.
>>
>>     Para quem não está acostumado é difícil entender
>>     que deve-se utilizar
>>
>>         $ man cd
>>
>>     ao invés de
>>
>>         $ man <cd>
>>
>
> A ideia é que o cheat sheet seja usado como referência após as
> nossas aulas, então não acho que vai ficar confuso.  Com certeza, as
> pessoas conseguem extrapolar os exemplos para resolverem sozinhas esse
> detalhe. :-)
>
> Ainda, pelo próprio conceito e formato de um Reference Guide, que já
> implica em espaço limitado, não acho viável nem produtivo inserir uma
> seção de notação.  Por fim, pelos outros exemplos e diversas linhas de
> "Usage" é possível entender que "man <cd>" não é correto.  Se você pegar
> alguns reference cards do projeto GNU, eles usam notação similar,
> trocando <> por [], sem explicar a notação.
>
> Da wikipedia, sobre "Cheat Sheets":
>
> "In more general usage, a "cheat sheet" is any short (one or two page)
> reference to terms, commands, or symbols where the user is expected to
> understand the use of such terms but not necessarily to have memorized
> all of them. Many computer applications, for example, have cheat sheets
> included in their documentation."

É...  Apesar de eu também ser chato com notação, concordo que, num cheat
sheet, fica meio complicado colocar uma parte de explicação da notação
(apesar de que não é impossível).  No entanto...

>> -   Manter a notação
>>
>>     E.g. Utilizar
>>
>>         $ cd ../<dir>
>>
>>     ao invés de
>>
>>         $ cd ../dir
>
> Nesse caso, pela própria explicação do texto, pode-se perceber que são
> coisas diferentes. Nesse caso, ../dir não é uma variável a ser
> substituída, mas um exemplo.  Talvez fique confuso mesmo, vou colocar
> essa linha adaptada como Usage.

Concordo que o certo aqui seria:

  $ cd ../<dir>

Porque você já havia usado <dir> no exemplo de cima.

>> -   Remover dd.
>
> O dd é citado nas Quick Tips como dica para gravar imagens de GNU.  Ele
> precisa ficar!  Por qual motivo você quer removê-lo?

O Raniere pode explicar melhor, mas acho que o motivo é que é um comando
"avançado".  Eu tendo a concordar com isso...

Nesse exemplo que você deu (de gravar imagens ISO), o usuário precisa
ser root (ouch!), e ele precisa especificar o device onde a imagem vai
ser gravada (ouch!!).  Nessa hora, um /dev/sda ao invés de /dev/sdb pode
ferrar com tudo.

-- 
Sergio
GPG key ID: 0x65FC5E36
Please send encrypted e-mail if possible
http://sergiodj.net/

signature.asc
Description: PGP signature