Skip to content

Conversation

@rajatarya
Copy link
Contributor

Attempt to reorganize Xet content so:

  • Storage Backends -> Storage Backend - Xet
  • Xet Protocol sections are subsections of Xet documentation
  • Set up docs for more visuals added to sections, make Xet more top-level visible in Hub docs.

@HuggingFaceDocBuilderDev

The docs for this PR live here. All of your documentation changes will be reflected on that endpoint. The docs are available until 30 days after the last update.

@rajatarya
Copy link
Contributor Author

image

The TOC doesn't seem to render well when it is 3 levels deep with longer subsection headers.

But this I believe is organized how Hub docs work - there are many small pages instead of larger ones - so I reorganized the main Storage Backends page into sections, and a TOC in the main page. The TOC can have deep links and then the navigation at the footer correctly goes to the next page in the section of docs.

@jsulz
Copy link
Contributor

jsulz commented Sep 26, 2025

I agree that the navigation is far improved, but the lack of margin-left on the final level in the TOC tree is kind of distracting.

What if we just removed the Open Source Xet Protocol and moved Building a client library for Xet storage and Overall Xet architecture one level up?

Copy link
Member

@julien-c julien-c left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ok i'm going to contradict myself from what i said in #1952 but probably makes more sense to keep the protocol in its own doc (/docs/xet) – given there are quite a number of pages and probably more in the future if some community-driven third party tools or implementations arise – while renaming the current Hub "entry point" page from /docs/hub/storage-backends to /docs/hub/xet.

WDYT?

@rajatarya rajatarya force-pushed the rajat/storage-backend-xet branch from b826967 to 51eab75 Compare October 2, 2025 22:36
@rajatarya
Copy link
Contributor Author

Argh, closing this PR and will create a new one - this one picked up too many changes in my attempts to rebase against main.

@rajatarya rajatarya closed this Oct 2, 2025
@rajatarya rajatarya deleted the rajat/storage-backend-xet branch October 2, 2025 23:19
@rajatarya rajatarya restored the rajat/storage-backend-xet branch October 2, 2025 23:19
@rajatarya rajatarya mentioned this pull request Oct 2, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.