hbase-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Daniel Vimont (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (HBASE-16279) Separate and rewrite intro and quickstart
Date Sun, 24 Jul 2016 04:15:20 GMT

    [ https://issues.apache.org/jira/browse/HBASE-16279?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15390934#comment-15390934

Daniel Vimont commented on HBASE-16279:

Hi [~misty],

I'm busy with other doings, so only had a couple of minutes to scroll down and scan through
the revised install-guide text.

One thing that leaped out and caught my eye:
bq. Installing HBase from source provides the most flexibility, and is not difficult.

I recommend removing the {{and is not difficult}} part.

As a fairly iron-clad rule in my instructional writing (particularly for children, but also
for adults), I strive to avoid adding in editorial comments regarding how "easy" I think it
is to do something. Otherwise, those who do (for reasons potentially umimaginable and unpredictable)
run into difficulties with some aspect of a task will be potentially encouraged to feel stupid,
give up, and go away.



> Separate and rewrite intro and quickstart
> -----------------------------------------
>                 Key: HBASE-16279
>                 URL: https://issues.apache.org/jira/browse/HBASE-16279
>             Project: HBase
>          Issue Type: Sub-task
>          Components: documentation
>            Reporter: Misty Stanley-Jones
>            Assignee: Misty Stanley-Jones
>             Fix For: 2.0.0
>         Attachments: HBASE-16279.patch

This message was sent by Atlassian JIRA

View raw message