[ 
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.

Thanks,

Dan

> 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
(v6.3.4#6332)

Reply via email to