samredai edited a comment on issue #3475: URL: https://github.com/apache/iceberg/issues/3475#issuecomment-962372928
Agreed there is a lot of information buried within a single sub-section. Although the extra level of nesting under `Spec` does get busy very fast (see the image below). <img width="1791" alt="Screen Shot 2021-11-05 at 7 13 39 PM" src="https://user-images.githubusercontent.com/43911210/140594439-2f77a16f-a68e-4d7a-a179-eaa3b3965153.png";> How about if we break them out into top sections under Format? The subsections in the page can then all be changed to `##` and be displayed in the navbar. ``` . └── Format ├── Definitions ├── Spec Overview ├── Spec Details ├── Table Metadata └── Appendices ``` Here are some screenshots of what that looks like:   -- 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]
![https://user-images.githubusercontent.com/43911210/140594439-2f77a16f-a68e-4d7a-a179-eaa3b3965153.png"](https://user-images.githubusercontent.com/43911210/140594439-2f77a16f-a68e-4d7a-a179-eaa3b3965153.png"){kind=link}
