Jim Apple has posted comments on this change.

Change subject: IMPALA-3398: Rework Impala documentation to be 

Patch Set 2:


 > Because I'm advocating re-doing the automated portions of this
 > change at a later time, I don't want to promote this patch set
 > as-is. Is it practical to say "abandon" for the code review but
 > still come back and pick out bits and pieces (e.g. the changes in
 > impala_jdbc.xml) to become part of a later code review?

Technically, yes - "Abandon"ed patches remain just as visible and can be 
resurrected with one click.

However, the usual way to do things is to just address the comments and upload 
a new "Patch Set", as I have done.

Commit Message:

Line 7: IMPALA-3398: Rework Impala documentation to be non-Cloduera-specific
> "Cloudera"

PS2, Line 16:     sed -i 's/ rev=""//g' $FILENAME
> Let's leave this step out, for a couple of reasons:

File docs/impala_html.ditaval:

PS2, Line 6: <prop att="audience" val="Hidden" action="exclude"/>
> That's fine. We will need to make the same addition in the Cloudera doc bui

Keep in mind that this gerrit instance, though hosted at cloudera.org, is for 
Apache Impala, so whatever choices Cloudera makes about their git repo is not 
really in-scope here.

File docs/topics/impala_alter_table.xml:

PS2, Line 25:       <indexterm audience="Hidden">ALTER TABLE 
> For the <indexterm> tags, maybe we could change those to audience="HTML" so
I think that's orthogonal to this change. It's usually best if patches address 
a single item, along with maybe some other trivial ones, not big ones like "Are 
index terms included".

As such, I'd suggest it go in another commit and we keep this one focused on 
excising "Cloudera"/"CDH"/"Cloudera Manager".

PS2, Line 220:     <p rev="2.3.0 IMPALA-1568">
> The reason I'm so liberal with release numbers and JIRA numbers with this r

PS2, Line 406:     <p>
> Here's a case where perhaps there is a corresponding IMPALA- JIRA number we

File docs/topics/impala_conversion_functions.xml:

PS2, Line 30:       Although in <keyword keyref="impala23_full"/>, the 
<codeph>SHOW FUNCTIONS</codeph> output for
> Just checking that this was a change introduced by Jim. This is a case wher
Yes, it was.

PS2, Line 443: <dlentry rev="2.3.0" id="casttosmallint" audience="Hidden">
> These castto*() functions might be intended to be permanently for internal 
I think that's an issue for a future patch, since it's a question of docs 
correctness, not of ASF/Cloudera separation.

PS2, Line 619: <dlentry rev="2.3.0" id="typeof">
> Hmm, this might have a corresponding IMPALA- JIRA number that should go in 
I'd call this future work.

File docs/topics/impala_jdbc.xml:

PS2, Line 82:         In Impala 2.0 and later, you must use the Hive 0.13 JDBC 
driver.  If you are
            :         already using JDBC applications with an earlier Impala 
release, you must update
            :         your JDBC driver, because the Hive 0.12 driver that was 
formerly the only choice
            :         is not compatible with Impala
> Urgh. "Must" seems like too strong a statement. I wonder if the right thing
Removed "must"s.

I'd say Apache Impala's docs should talk about open-source JDBC drivers and 
vendor's docs should talk about their own JDBC drivers.

PS2, Line 120:           To get the JAR files, install the Hive JDBC driver on 
each host in the cluster that will run
> It's worth checking if there's a generic Hadoop or Hive URL we could refer 
Couldn't find one; added TODO

PS2, Line 139:   hive-common-X.XX.X.jar
             :   hive-jdbc-X.XX.X.jar
             :   hive-metastore-X.XX.X.jar
             :   hive-servi
> We should confirm that these filenames are accurate if someone goes the gen
I poked around on Google and it appears so.

PS2, Line 161:               <xref 
scope="external" format="html">this
> Ironic that there's a reference to "Cloudera Impala" that perhaps we could 

To view, visit http://gerrit.cloudera.org:8080/5239
To unsubscribe, visit http://gerrit.cloudera.org:8080/settings

Gerrit-MessageType: comment
Gerrit-Change-Id: Ib3f63fb309e0617d7fe014231bb0ab0ad67c8474
Gerrit-PatchSet: 2
Gerrit-Project: Impala-ASF
Gerrit-Branch: master
Gerrit-Owner: Jim Apple <jbapple-imp...@apache.org>
Gerrit-Reviewer: Anonymous Coward #250
Gerrit-Reviewer: Greg Rahn <gr...@cloudera.com>
Gerrit-Reviewer: Jim Apple <jbapple-imp...@apache.org>
Gerrit-Reviewer: John Russell <jruss...@cloudera.com>
Gerrit-HasComments: Yes

Reply via email to