diff --git a/docs/hub/_toctree.yml b/docs/hub/_toctree.yml index 85141fa10d..01720e6add 100644 --- a/docs/hub/_toctree.yml +++ b/docs/hub/_toctree.yml @@ -552,6 +552,8 @@ title: Paper Pages - local: academia-hub title: Academia Hub + - local: blog-articles + title: Blog Articles - local: search title: Search - local: doi diff --git a/docs/hub/blog-articles.md b/docs/hub/blog-articles.md new file mode 100644 index 0000000000..d4e0234f63 --- /dev/null +++ b/docs/hub/blog-articles.md @@ -0,0 +1,51 @@ +# Blog Articles + +Blog Articles let you publish long-form content directly on the Hub — model releases, research updates, tutorials, and announcements — and share them with the broader community. Articles can be published under your personal namespace or under an [organization](./organizations) you belong to. + +## Who Can Publish Blog Articles + +To publish under **your personal namespace**, you need a confirmed email and must satisfy at least one of the following: + +- You have an active [PRO](./pro) subscription. +- You are a member of a [Team or Enterprise](https://huggingface.co/enterprise) organization (with `write` or `admin` role in that organization). + +Managed users (users provisioned through Enterprise IdP) cannot publish under their personal namespace. + +To publish under an **organization namespace**, both must hold: + +- The organization is on the [Team or Enterprise](https://huggingface.co/enterprise) plan. +- You have the `write` or `admin` role in that organization. See [Access Control in Organizations](./organizations-security) for more on roles. + +See [Blog Articles for Organizations](./enterprise-blog-articles) for organization-specific details. + +## Creating a Blog Article + +Go to [huggingface.co/new-blog](https://huggingface.co/new-blog) to start a new article. You can write in Markdown, embed media, and reference models, datasets, and Spaces hosted on the Hub. + +When creating the article, pick the namespace it should be published under from the dropdown: + +- **Your username** — the article appears on your user profile. +- **An organization** — the article appears on that organization's profile page. + +
+ + +
+ +## Editing an Article + +- Articles published under a user namespace can be edited by the original author and any coauthors listed on the article. +- Articles published under an organization namespace can be edited by any organization member with `write` or `admin` role. + +## Linking to Models and Datasets + +When a blog article mentions a model or dataset, and the article's author (user or organization) is the same as the repo's owner, the article will automatically appear in the sidebar of that model or dataset page under **"Article(s) mentioning [repo-id]"**. Up to three of the most recent matching articles are shown. + +
+ + +
+ +This makes it easy for visitors to discover related write-ups, release announcements, and research notes alongside the repository itself. + +If the article references a [Collection](./collections), every model and dataset in that collection is treated as linked — the article will surface on each member repo's page (subject to the same ownership rule). diff --git a/docs/hub/enterprise-blog-articles.md b/docs/hub/enterprise-blog-articles.md index f3bac9b6c2..0c71c9cc5c 100644 --- a/docs/hub/enterprise-blog-articles.md +++ b/docs/hub/enterprise-blog-articles.md @@ -15,3 +15,9 @@ To publish blog articles under an organization namespace, members need `write` o > [!NOTE] > Blog article permissions are currently tied to organization-level roles and cannot be scoped using [Resource Groups](./security-resource-groups). Resource Groups only control access to repositories (models, datasets, and Spaces), not blog articles. + +## Linking to Models and Datasets + +Articles mentioning a model or dataset owned by the same organization will automatically surface on that repo's page. See [Linking to Models and Datasets](./blog-articles#linking-to-models-and-datasets) for details. + +See [Blog Articles](./blog-articles) for general information about authoring blog articles on the Hub. diff --git a/docs/hub/index.md b/docs/hub/index.md index 91552cbe55..780daedffb 100644 --- a/docs/hub/index.md +++ b/docs/hub/index.md @@ -133,6 +133,8 @@ The Hugging Face Hub is the reference AI platform for open ML. It hosts over 2M Security Moderation Paper Pages +Academia Hub +Blog Articles Search Digital Object Identifier (DOI) Hub API Endpoints diff --git a/docs/hub/models-faq.md b/docs/hub/models-faq.md index 3b4db4b03e..78bd029b02 100644 --- a/docs/hub/models-faq.md +++ b/docs/hub/models-faq.md @@ -22,6 +22,10 @@ The Hugging Face Hub is also home to Spaces, which are interactive demos used to Spaces are a great way to show off a model you've made or explore new ways to use existing models! Visit the [Spaces documentation](./spaces) to learn how to make your own. +## Are community blog articles linked to models? + +Yes — if you publish a [blog article](./blog-articles) that mentions a model you own (as a user or organization), it will automatically appear in the model page sidebar. The same applies to dataset pages. See [Linking to Models and Datasets](./blog-articles#linking-to-models-and-datasets) for details. + ## How do I upload an update / new version of the model? Releasing an update to a model that you've already published can be done by pushing a new commit to your model's repo. To do this, go through the same process that you followed to upload your initial model. Your previous model versions will remain in the repository's commit history, so you can still download previous model versions from a specific git commit or tag or revert to previous versions if needed.