rdblue edited a comment on pull request #2:
URL: https://github.com/apache/iceberg-docs/pull/2#issuecomment-994162460


   Here are a few notes from clicking around:
   * Is the final path going to be `iceberg.apache.org/iceberg-docs`? Why not 
make the landing page at the root level?
   * In the preview, the "Learn More" link is broken. It points to 
https://samredai.github.io/docs instead of 
https://samredai.github.io/iceberg-docs/docs/, which is where the docs link 
takes you.
   * Since we also have a new front page, what about having the Docs link send 
you to a Getting Started page?
   * Clicking on "Tables" in the docs left nav is an empty page. Maybe we can 
make that a set of links to learn more about general table topics?
   * Same with Integrations, API, and Format. The text is a link, but there's 
no page there.
   * Under releases, should we include "latest"?
   * The About page is odd and just links to other pages
   * Looks like the ASF and About nav pages are there because we've removed the 
subpages from the nav. Is it possible to make those collapsible?
   * It's hard to find the pages under About. Those pages are important, like 
Blogs, Talks, Community, Releases, etc.
   * What does search do? When I search for something like 
`write.format.default`, there isn't much context, only a list of pages that 
look unrelated. The pages also show up in the nav and push everything down.
   * Clicking the Iceberg logo in the upper left in /docs brings you back to 
the docs splash page, not the Iceberg splash site.
   * The splash site uses "Mailing lists" instead of "Community". Could you 
link to the community page instead?
   * On the splash page, I think we should add links to the features that are 
highlighted. We should also consider what to put here. The 3 listed don't seem 
compelling enough.


-- 
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: dev-unsubscr...@iceberg.apache.org

For queries about this service, please contact Infrastructure at:
us...@infra.apache.org


Reply via email to