All of lore.kernel.org
 help / color / mirror / Atom feed
From: Patrick Williams <patrick@stwcx.xyz>
To: Andrew Geissler <geissonator@gmail.com>
Cc: Joel Stanley <joel@jms.id.au>,
	OpenBMC Maillist <openbmc@lists.ozlabs.org>,
	Brad Bishop <bradleyb@fuzziesquirrel.com>
Subject: Re: Opinions on CLI tools.
Date: Sun, 6 Nov 2016 22:01:41 -0600	[thread overview]
Message-ID: <20161107040141.GD15757@heinlein.lan> (raw)
In-Reply-To: <CALLMt=oSw8qupiSjqzCTsByYqjRMwEaiiY5nmaRGABrnFTWPyQ@mail.gmail.com>

[-- Attachment #1: Type: text/plain, Size: 1528 bytes --]

On Thu, Nov 03, 2016 at 09:00:28AM -0500, Andrew Geissler wrote:
> I still feel like we're doing a lot of "developer-biased" decision
> making here.  We're going to have people in the lab and other general
> users of obmc that shouldn't have to understand the details of our
> implementation of things like service states and such.

I don't think this is "developer-biased" as much as you are implying it
is.  There are two kinds of people...

    1) Person who has some familiarity with existing open source tools.
    2) Person who has no familiar with existing open source tools.

For person #1, if we document power-on is "systemctl start
host-power-on@1.target" they have learned something about our system and
they might be able to learn more on their own through exploration.  If
we document power-on is "obmcutil power-on" we have taught them nothing.

For person #2, if we document power-on is "systemctl start
host-power-on@1.target" they will copy and paste it into a terminal.  If
we document power-on is "obmcutil power-on" they will copy and paste it
into a terminal.

We haven't lost anything by not providing "obmcutil power-on" except 15
extra characters.  We have lost something by providing (and documenting)
"obmcutil power-on".

You use the term "developer-biased" but it is really "general Linux
knowledge" biased.  Person #2 doesn't have it and probably never will;
they are going to be a "copy and paste" user their whole life so why
cater to them?

-- 
Patrick Williams

[-- Attachment #2: Digital signature --]
[-- Type: application/pgp-signature, Size: 801 bytes --]

      reply	other threads:[~2016-11-07  4:02 UTC|newest]

Thread overview: 6+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2016-10-31 15:00 Opinions on CLI tools Patrick Williams
2016-11-01 13:30 ` Brad Bishop
2016-11-01 22:11   ` Xo Wang
2016-11-01 23:50     ` Joel Stanley
2016-11-03 14:00       ` Andrew Geissler
2016-11-07  4:01         ` Patrick Williams [this message]

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20161107040141.GD15757@heinlein.lan \
    --to=patrick@stwcx.xyz \
    --cc=bradleyb@fuzziesquirrel.com \
    --cc=geissonator@gmail.com \
    --cc=joel@jms.id.au \
    --cc=openbmc@lists.ozlabs.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.