1 |
Greetings, |
2 |
|
3 |
I'm not filing a bug but writing here, because i think that this case |
4 |
needs policy change and some discussion in the team before that as it |
5 |
will lead to really lots of fixing in our docs. |
6 |
|
7 |
Now situation looks really strange. We encourage users not to use root |
8 |
account in security docs, but all over our place, in every code |
9 |
listing, we have root prompt ("#") which suggests users to use that |
10 |
account to perform all the actions. |
11 |
|
12 |
My idea is that we should use "$" - user prompt - whereever command can |
13 |
be or should be run as normal user. |
14 |
|
15 |
Example? |
16 |
|
17 |
http://www.gentoo.org/proj/en/gdp/doc/doc-tipsntricks.xml: |
18 |
|
19 |
# wget http://www.gentoo.org/dyn/doc-snapshots/docs-latest-en.tar.bz2 |
20 |
|
21 |
Why we should download it as root? Why not just: |
22 |
|
23 |
$ wget http://www.gentoo.org/dyn/doc-snapshots/docs-latest-en.tar.bz2? |
24 |
|
25 |
For me, it could reduce bad behaviour of doing simple commands as root, |
26 |
which is not needed and should be avoided as much as possible. |
27 |
|
28 |
Of course i know that when all our docs contain such prompts, fixing it |
29 |
would cost lots of resources and can accept if you refuse due to that. |
30 |
|
31 |
I also know that users don't have to be informed what those strange |
32 |
prompt signs (#, $) mean, but that can be easily solved with small note |
33 |
in index.xml files. |
34 |
|
35 |
I'm waiting for your opinions. |
36 |
|
37 |
with kind regards, |
38 |
|
39 |
£ukasz Damentko |
40 |
|
41 |
(who bought many extra fingers already) |
42 |
|
43 |
-- |
44 |
gentoo-doc-pl@g.o mailing list |