Add More Documentation - Githubissues

Netflix / iceberg

Iceberg is a table format for large, slow-moving tabular data

Apache License 2.0

478 stars 60 forks source link

Add More Documentation #104

Open omervk opened 5 years ago

omervk commented 5 years ago

It would be great to add a bunch of documentation:

Design of each part of the system (from TableOperations to Expressions, etc.)
Tradeoffs taken in the design of the table format
Context bounds - what is and isn't in scope for Iceberg
What you need to do to replace Hive with your own metastore
Bootstrapping your own use of Iceberg
Reasoning for limiting what's possible with Avro schemas

omervk commented 5 years ago

@rdblue I think this may be the most pressing issue for the project, especially since it's now an Apache project (incubating). I'll be happy to take up some of it if you like.

rdblue commented 5 years ago

@omervk, it would be great to have docs contributions! We just created a mkdocs site for the Iceberg incubator project, so you can add docs through pull requests to site on the Iceberg incubator project.

omervk commented 5 years ago

Great! How will you be working with the other repo? Archiving the current one? Will you be migrating the issues, too?

rdblue commented 5 years ago

Yes, I'll migrate the issues and then turn off issue tracking here.