samredai opened a new issue, #4607:
URL: https://github.com/apache/iceberg/issues/4607

   Now that we have a proposal for the new navigation flow, we need to 
translate that to action items. So far there seems to be consensus that we need 
to move all of the non-versioned material (concepts, quickstarts, and 
overviews) over to the landing-page and reserve the versioned docs-site for 
configuration/reference type of material that's expected to include changes 
with every Iceberg release. The landing-page markdown files are stored in the 
[iceberg-docs](https://github.com/apache/iceberg-docs/tree/main/landing-page/content/common)
 repo.
   
   Some good first items are:
   - [ ] Move quickstarts to landing-page site (docker-compose and a few 
quickstart code snippets)
   - [ ] Create a single configuration page with only tables of all 
configuration parameters (Catalog/Table/Compute Engine)
   - [ ] Create a high level "Catalog" concept page (no code snippets here)
   - [ ] Create a high level "Table" concept page (no code snippets here)
   - [ ] Create a high level "Snapshots" concept page (no code snippets here)
   - [ ] Create a high level "FileIO" concept page (no code snippets here)
   
   
![iceberg-docs-proposal](https://user-images.githubusercontent.com/43911210/164499437-39db663a-1192-4566-9bab-cb9a741dcd68.png)
   


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]


---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to