sqoop-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Jarek Jarcec Cecho (JIRA)" <j...@apache.org>
Subject [jira] [Updated] (SQOOP-2826) Sqoop2: Doc: Auto-generate connector pages
Date Wed, 09 Mar 2016 23:05:40 GMT

     [ https://issues.apache.org/jira/browse/SQOOP-2826?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel

Jarek Jarcec Cecho updated SQOOP-2826:
    Attachment: SQOOP-2826.patch

Uploading new version of the patch - still not ready to be reviewed as it's WIP that depends
on half a dozen patches that are currently under review.

> Sqoop2: Doc: Auto-generate connector pages
> ------------------------------------------
>                 Key: SQOOP-2826
>                 URL: https://issues.apache.org/jira/browse/SQOOP-2826
>             Project: Sqoop
>          Issue Type: Sub-task
>            Reporter: Jarek Jarcec Cecho
>            Assignee: Jarek Jarcec Cecho
>             Fix For: 1.99.7
>         Attachments: SQOOP-2826.patch, SQOOP-2826.patch
> Our current pages describing connectors are heavily outdated. This happened because we've
added bunch of new configuration properties in various patches, but forget to update the docs.
Whereas we could force every connector changing patch to also update the docs, I think that
keeping the same information on two places is tedious. Much better option would be to automatically
generate connector documentation pages from our code.
> To be very specific, I can see at least two areas where auto generating content would
really help:
> * [Generating input list for connectors|http://sqoop.apache.org/docs/1.99.6/Connectors.html]
> * [Generating command line parameters|http://sqoop.apache.org/docs/1.99.6/CommandLineClient.html]
> I'm sure that there will be others :)

This message was sent by Atlassian JIRA

View raw message