Hey all,

I have some proposals I'd like to make to fixing the docs. I would want to
do this in two phases.

The first phase I'm proposing that we locate all the documentation
(reference docs, website, and pyIceberg) back into the apache/iceberg
repository. I explain my reasoning in the attached document. This phase
would also update us from Hugo to MkDocs but keep all the content the same.

The second phase, is focused on iteratively building out the content that
we've marked missing in some the proposal that Sam R. created along with a
recent community member, Mahfuza. We will also restructure the content to
following the diátaxis method (https://diataxis.fr/).

https://docs.google.com/document/d/1WJXzcwC6isfoywcLY2lZ9gZN6i0JU1I2SIZmCkumbZc/edit#heading=h.gli9mc2ghfz1

Let me know what you think and bring on the questions and criticisms
please! :)

Bits

Reply via email to