Docs: add missing pages (about, benchmarks, fileio, security) to site…

[enesyesil]

Closes #14411

[ebyhr]

Could you please add a screenshot to the PR description? It will help the reviewers.

[kevinjqliu]

Thanks for working on this.

You can run make serve in the site/ dir to render the site locally so that we can preview the changes.
We should also figure out where best to places these links within the nav

[enesyesil]

Thanks for the feedback.
I also noticed in #14399
that suggested the following structure:
“FileIO could go under the API section, About can be removed, and the rest can be moved into the Project tab.”

Before I make any further updates, could you please confirm if this layout is preferred? and I will also include a screenshot of updated nav layout in the PR.

[kevinjqliu]

I think FileIO under API makes sense

• https://iceberg.apache.org/fileio/
• https://iceberg.apache.org/docs/nightly/api/

We can get rid of About, the same paragraph is on the homepage

• https://iceberg.apache.org/about/

Benchmark and Security in the project tab also makes sense

• https://iceberg.apache.org/contribute/
• https://iceberg.apache.org/benchmarks/
• https://iceberg.apache.org/security/

[enesyesil]

Hi, I just pushed the latest changes. the File I/O link was added under the api section, other links also updated. Please have a look when you get a chance, and let me know if I should adjust anything else. Thanks a lot for the help and feedback

[kevinjqliu]

thanks @enesyesil

could you run make serve-dev locally from the site/ dir to preview the changes and post the preview?

[kevinjqliu]

weird thing i noticed while rendering this locally.

api.md / https://iceberg.apache.org/docs/nightly/api/
has a side bar

but fileio does not.

i didnt see where this is controlled but would be good to keep the consistency here

[enesyesil]

Hi, yeah I guess the reason is that MkDocs builds from the docs/ directory, so linking with ../../fileio/ jumps outside the build and loses the sidebar context.

Do you think it would be better to move the fileio docs into docs/, or just mirror them there to keep consistency?

[enesyesil]

[enesyesil]

Sorry for the delay. File I/O now appears under the API section with the sidebar showing correctly, I verified locally.
Thanks for the review.