ubuntu-manual team mailing list archive

[Thomas Cantara <tacantara@xxxxxxxxx>]

Again, from the "noob perspective," I agree with the code blocks.  The
samples that Wolter provides are nice, as they don't look like the standard
code blocks on the Ubuntu Forum.  I also agree with Jamin's suggestion to
drop the $ and # symbols.  I had to train myself to not add those in, as
they were already part of the command line prompt.  It looks like this
manual is really starting to take shape.

On Fri, Jan 8, 2010 at 04:06, Jamin Day
<jaminday+ubuntu@xxxxxxxxx<jaminday%2Bubuntu@xxxxxxxxx>
> wrote:

> Hi Wolter,
>
> I agree that code blocks are important to help distinguish for the reader
> what should be entered into a terminal. However, perhaps it will become too
> confusing to have '#' for root commands and '$' for normal commands?
> Remember our target audience are beginners so we want to be specific
> and avoid confusion wherever possible. Also we are trying to teach how to
> use *Ubuntu*, not how to be competent on any linux distro they pick up. I
> could be wrong but I doubt we will even need to tell anyone to open a root
> terminal at all, save for maybe in the advanced section (which will still be
> aimed at beginners, but just have a little more depth). For most of the
> commands we will discuss I'm sure it will be sufficient to just run a
> standard terminal and use sudo, in which case we should *write *sudo in
> our code blocks when it's necessary.
>
> PS - I'm loving your artwork so far! Keep it up!
>
> Jamin
>
>
> On Fri, Jan 8, 2010 at 7:54 PM, Jamin Day <jaminday+ubuntu@xxxxxxxxx<jaminday%2Bubuntu@xxxxxxxxx>
> > wrote:
>
>> How about using something like this for code blocks?
>>
>> \fcolorbox{Bittersweet}{White}{
>> \texttt{\$sudo apt-get autoremove}
>> }
>>
>> You end up with something like the following example:
>>
>> http://imagebin.org/78854
>>
>> I'm not great at latex so it's probably not a very elegant solution, but
>> it's a start perhaps...
>>
>> Jamin
>>
>>
>> On Fri, Jan 8, 2010 at 6:14 PM, Wolter Hellmund <wolterh6@xxxxxxxxx>wrote:
>>
>>> Ok, I think that code blocks is the only way to go as for this matter.
>>> Why? They make it easy to distinguish between what is author-written
>>> normal text and what is a command or something.
>>> Now, I have a little suggestion here respecting commands.
>>> Commands to be entered as root should be preceded with a # character,
>>> and non-root commands with a $ character. Of course, it should be
>>> previously explained to users that sudo, or even su can enable root user
>>> mode.
>>> Why? Because then, when a user goes into another linux distro, and tries
>>> to use sudo, he won't be able to. Moreover, if he opened a root terminal
>>> he would still attempt to use sudo which would be... um.. unuseful, to
>>> be polite.
>>>
>>> So, I think that code blocks are the way to go for terminal input and
>>> other instructions of that sort.
>>>
>>> Now, as for routes as to where to click and such, I think that we could
>>> have different types of code blocks, as in having different icons for
>>> each type. For example, terminal input code blocks must have a terminal
>>> icon, of course. Routes (as in System > Preferences > ...) must have
>>> another icon. What will that icon be? I don't know. Lets figure that out
>>> later.
>>>
>>> Sorry for the big post team. I hope I did not just rant in here.
>>>
>>>
>>>
>>> _______________________________________________
>>> Mailing list: https://launchpad.net/~ubuntu-manual<https://launchpad.net/%7Eubuntu-manual>
>>> Post to     : ubuntu-manual@xxxxxxxxxxxxxxxxxxx
>>> Unsubscribe : https://launchpad.net/~ubuntu-manual<https://launchpad.net/%7Eubuntu-manual>
>>> More help   : https://help.launchpad.net/ListHelp
>>>
>>
>>
>
> _______________________________________________
> Mailing list: https://launchpad.net/~ubuntu-manual<https://launchpad.net/%7Eubuntu-manual>
> Post to     : ubuntu-manual@xxxxxxxxxxxxxxxxxxx
> Unsubscribe : https://launchpad.net/~ubuntu-manual<https://launchpad.net/%7Eubuntu-manual>
> More help   : https://help.launchpad.net/ListHelp
>
>