logo       

Re: serverguide methodology: msg#00160

Subject: Re: serverguide methodology
On Sat, 2005-12-17 at 17:04 +0530, Bhuvaneswaran wrote:
> > (e.g. sudo vim filename), and sometimes it simply says "edit the file
> > [filename]". I personally prefer the second approach, I think the guide
> 
> Ok. IMO, we can use sudo vim filename on all occassions. The reason
> being, we may not expect the user to follow the entire document. He
> may be using the document to install a single application. So, he may
> concentrate on just one application. So, IMO, we can specify the
> command to edit the file on all sections. Feedbacks are welcome.

I disagree. I think that it is a lot better to go "editor-agnostic" as
Og Maciel put it. The reason for this is that it seems over the top to
me to continually spell out the command that a user needs to edit a
file: this is a serverguide, and almost every single entry will involve
editing files. I agree, we shouldn't expect everyone to read the whole
document, but this problem can be avoided if the word "edit" is linked
to the section of the document which explains how to edit. That way,
users who know don't click, and those who don't, can click, until they
have learnt.

> > new users won't be able to use it properly, while they will be able to
> > use nano. Experienced users can use whatever they like.
> 
> We're using vim based on the decision we took in one meeting. We're
> open to use nano though. Feedbacks are welcome.

I vote for nano: it is much easier, and everyone can use it, experienced
or beginners alike. Those who like vim, can use vim (see the
editor-agnostic approach, above).

Matt
-- 
mdke@xxxxxxxxxx
gnupg pub 1024D/0E6B06FF

Attachment: signature.asc
Description: This is a digitally signed message part


<Prev in Thread] Current Thread [Next in Thread>
Google Custom Search

Recently Viewed:
science.linguis...    culture.sf.lite...    video.mplayer.c...    yellowdog.gener...    ietf.rfc822/199...    emacs.help/2002...    redhat.release....    kernel.speakup/...    java.openejb.de...    debian.devel.gt...    xfree86.newbie/...    bug-tracking.ma...    pam/2003-05/msg...    games.devel.ope...    user-groups.lin...    music.pancham/2...    network.mq.deve...    web.html.genera...    arklinux.bugs/2...    linux.ecasound/...    qnx.openqnx.dev...    org.user-groups...    file-systems.sf...    trustix.contrib...   
Home | blog view | USPTO Patent Archive | advertise | OSDir is an inevitable website. super tiny logo

Free Magazines

Cisco News
Receive a free quarterly e-newsletter with exclusive articles on how Cisco IT uses its own products and solutions to enable the business.
subscribe

Systems Management News, the newspaper for IT systems administration and data center managers! Each issue of Systems Management News is chock-full of news and analysis to help you understand what's happening in your field.
subscribe

The Enterprise Newsweekly eWeek is the essential technology information source for builders of e-business.
subscribe

Oracle Magazine Oracle Magazine contains technology strategy articles, sample code, tips, Oracle and partner news, how to articles for developers and DBAs, and more. Oracle (NASDAQ: ORCL) is the world's largest enterprise software company.
subscribe

Total Telecom Total Telecom is "The Economist of the communications industry".
subscribe