docs: note that buckets render README.md (#2475)

* docs: note that buckets render README.md

Adds a short subsection under "Browsing Buckets on the Hub" documenting
that README.md files render at the bucket root and inside subdirectories.
Updates the repos-vs-buckets comparison table accordingly.

Verified against a test bucket.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* docs: add "Listing from the CLI" subsection header

Orphaned "You can also list bucket contents from the CLI" between two H3s.
Give it its own header so the section structure reads cleanly.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* Update docs/hub/storage-buckets.md

Co-authored-by: Julien Chaumond <julien@huggingface.co>

* docs: realign table column after suggestion edit

The accepted suggestion lengthened the third-column cell but kept the
original trailing padding, pushing the closing pipe past the column
boundary. Trim trailing spaces so the column aligns again.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Co-authored-by: Julien Chaumond <julien@huggingface.co>

Author: 3 people

docs/hub/storage-buckets.md

@@ -22,7 +22,7 @@ The Hub offers two types of storage: Git-based **repositories** for versioned, c
 | Operations         | Hub API, Git push/pull          | S3-like `sync`, `cp`, `rm`          |
 | Deduplication      | Xet chunk-level                 | Xet chunk-level                     |
 | Pull Requests      | Yes                             | No                                  |
-| Model/Dataset Cards| Yes                             | No                                  |
+| Model/Dataset Cards| Yes                             | No (but plain README rendered)      |
 
 Use **repositories** when you want version history, collaboration features (PRs, discussions), and library integrations. Use **buckets** when you need fast, mutable storage for data that changes frequently — files can be overwritten or deleted in place.
 
@@ -94,6 +94,12 @@ Every bucket has a page on the Hub where you can browse its contents, navigate d
 <img class="hidden dark:block" src="https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/hub/buckets/buckets-file-browser-dark.png"/>
 </div>
 
+### README rendering
+
+If a directory in your bucket contains a `README.md` file, the Hub renders it below the file list on that directory's page. This works both at the bucket root and inside any subdirectory — useful for documenting what a bucket contains, how data is organized, or how downstream tools should consume it.
+
+### Listing from the CLI
+
 You can also list bucket contents from the CLI:
 
 ```bash