[jira] [Commented] (SQOOP-2667) Sqoop2: Improve documentation

["ASF subversion and git services (JIRA)" <ji...@apache.org>]

    [ https://issues.apache.org/jira/browse/SQOOP-2667?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15003254#comment-15003254 ] 

ASF subversion and git services commented on SQOOP-2667:
--------------------------------------------------------

Commit 60f54b624b3ebffb10dfa6f5de58b6f42ecedff6 in sqoop's branch refs/heads/sqoop2 from [~hshreedharan]
[ https://git-wip-us.apache.org/repos/asf?p=sqoop.git;h=60f54b6 ]

SQOOP-2667. Sqoop2: RESTiliency: Refactore the one line try-catch statement in InvalidRESTTest

(Jarcec via Hari)


> Sqoop2: Improve documentation
> -----------------------------
>
>                 Key: SQOOP-2667
>                 URL: https://issues.apache.org/jira/browse/SQOOP-2667
>             Project: Sqoop
>          Issue Type: Bug
>    Affects Versions: 1.99.6
>            Reporter: Jarek Jarcec Cecho
>            Assignee: Jarek Jarcec Cecho
>             Fix For: 1.99.7
>
>
> We've put together roots of current documentation system more then 3 years ago for our first 1.99.1 cut of Sqoop 2.  We've only incrementally added few pages since then. I recently looked into the docs more carefully as I wanted to improve HDFS connector and I would like to propose quite huge overhaul - few of the things that immediately came to my mind:
> * I'm really missing a table of context on each page to navigate though the entire documentation suite (in some side menu or something)
> * On any formatting error, we print out exception to the documentation and won't fail the build.
> * We build the docs in all profiles, even though that it make sense only for {{binary}} profile.
> * The connector docs are really, really old - bunch of newly added arguments are not mentioned there.
> * In terms of connectors - it seems to me that the docs are focusing on dev rather then end user, so I would like to add more context there.



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)