[SQOOP-2826] Sqoop2: Doc: Auto-generate connector pages

• Type: Sub-task
• Status: Open
• Priority: Major
• Resolution: Unresolved
• Fix Version/s: 1.99.8
• Assignee: Jarek Jarcec Cecho
• Reporter: Jarek Jarcec Cecho
• Created: 07/Feb/16 18:04
• Updated: 28/Jul/16 00:13

Description

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
• Generating command line parameters

I'm sure that there will be others

Issue Links

• depends upon: SQOOP-2827 Sqoop2: Doc: Provide doc preprocessor facilities
• depends upon: SQOOP-2854 Sqoop2: Enrich connector resource files
• depends upon: SQOOP-2853 Sqoop2: Refactor TableDisplayer to be used in document generation