Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Documentation Revamp #156

Merged
merged 41 commits into from
Jun 1, 2022
Merged

Documentation Revamp #156

merged 41 commits into from
Jun 1, 2022

Conversation

NimaBoscarino
Copy link
Contributor

@NimaBoscarino NimaBoscarino commented May 25, 2022

(#62) This PR reorganizes the existing Hub docs, and adds some new content to cover previously undocumented features. The docs have been reworked to be delivered via doc-builder, and as such changes to moon landing are required (https://github.com/huggingface/moon-landing/pull/2955).

For an overview of the structure of the docs, visit Notion (closed access). In short, the docs are structures around:

  • Repositories
  • Models
  • Spaces
  • Datasets
  • (Orgs, Security, API)

Something that didn't make it into here yet is "Best practices for handling multiple experiments" -- @osanseviero do you think it would be okay for this to be in a future PR? I've read through #53 but I don't quite know enough to write something useful up for it at the moment.

The following PRs should be merged into this branch (or at least merged after this PR):

NimaBoscarino and others added 14 commits May 20, 2022 14:06
Create Hugging Face Hub main doc page, with bolded items intended as future links to docs.

Co-authored-by: Steven Liu <59462357+stevhliu@users.noreply.github.com>
Add a "Repositories" page with several subpages, outlining how repos
are used on the hub, and best practices for creating and maintaining them.

Some content remains WIP.

Co-authored-by: Omar Sanseviero <osanseviero@gmail.com>
Co-authored-by: Steven Liu <59462357+stevhliu@users.noreply.github.com>
Create Hugging Face Hub main doc page, with bolded items intended as future links to docs.

Co-authored-by: Steven Liu <59462357+stevhliu@users.noreply.github.com>
Add content for models, and move deprecated content to its own folder (for dev purposes).

Co-authored-by: Steven Liu <59462357+stevhliu@users.noreply.github.com>
Add documentation for Spaces, with tutorial for Gradio and Streamlit.

Co-authored-by: Steven Liu <59462357+stevhliu@users.noreply.github.com>
Add documentation for Datasets
Add docs for organizations, security, API

Co-authored-by: Steven Liu <59462357+stevhliu@users.noreply.github.com>
Co-authored-by: Omar Sanseviero <osanseviero@gmail.com>
Modify docs to make them compatible with doc-builder.
* Docs Revamp: Models documentation (#117)

Add content for models, and move deprecated content to its own folder (for dev purposes).

Co-authored-by: Steven Liu <59462357+stevhliu@users.noreply.github.com>

* [Spaces] Changelog update

* Update docs/hub/spaces-changelog.md

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

* Update docs/hub/spaces-changelog.md

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

* Update docs/hub/spaces-changelog.md

Co-authored-by: Omar Sanseviero <osanseviero@gmail.com>

* Update docs/hub/spaces-changelog.md

Co-authored-by: Omar Sanseviero <osanseviero@gmail.com>

* Update docs/hub/spaces-changelog.md

Co-authored-by: Omar Sanseviero <osanseviero@gmail.com>

* Update docs/hub/spaces-changelog.md

Co-authored-by: Omar Sanseviero <osanseviero@gmail.com>

* Update docs/hub/spaces-changelog.md

Co-authored-by: Omar Sanseviero <osanseviero@gmail.com>

* Misc changes

* Fix rebase mistakes

* Fix merge conflict

Co-authored-by: Nima Boscarino <nima@huggingface.co>
Co-authored-by: Steven Liu <59462357+stevhliu@users.noreply.github.com>
Co-authored-by: Julien Chaumond <julien@huggingface.co>
Co-authored-by: Omar Sanseviero <osanseviero@gmail.com>
Co-authored-by: Nima Boscarino <nima.boscarino@gmail.com>
@HuggingFaceDocBuilderDev

The docs for this PR live here. All of your documentation changes will be reflected on that endpoint.

@mishig25
Copy link
Collaborator

Can we rename files *-main without -main?
For example: https://moon-ci-docs.huggingface.co/docs/hub/pr_156/en/models-main

julien-c and others added 7 commits May 25, 2022 11:40
* Docs Revamp: Models documentation (#117)

Add content for models, and move deprecated content to its own folder (for dev purposes).

Co-authored-by: Steven Liu <59462357+stevhliu@users.noreply.github.com>

* split Repo licenses into its own page

* Some initial doc about pull-requests and discussions

Co-authored-by: Nima Boscarino <nima@huggingface.co>
Co-authored-by: Steven Liu <59462357+stevhliu@users.noreply.github.com>

```bash
[remote "origin"]
fetch = +refs/pr/*:refs/remotes/origin/pr/*
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
fetch = +refs/pr/*:refs/remotes/origin/pr/*
fetch = +refs/pr/*:refs/remotes/origin/pr/*

Copy link
Member

@stevhliu stevhliu left a comment

Choose a reason for hiding this comment

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

Second wave incoming! 🌊

Left a small suggestion to maybe use doc-builder's callouts for tips and warning since I think these look really nice :) I think these will have to be mdx files though.

docs/hub/security-malware.md Outdated Show resolved Hide resolved
docs/hub/security-tokens.md Outdated Show resolved Hide resolved
docs/hub/organizations-security.md Outdated Show resolved Hide resolved
docs/hub/models-interacting.md Outdated Show resolved Hide resolved
NimaBoscarino and others added 2 commits May 25, 2022 16:52
Co-authored-by: Steven Liu <59462357+stevhliu@users.noreply.github.com>
@NimaBoscarino NimaBoscarino requested a review from stevhliu May 26, 2022 00:00
Copy link
Member

@Pierrci Pierrci left a comment

Choose a reason for hiding this comment

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

I made it through! Looks really cool! 🔥

docs/hub/repositories-getting-started.md Outdated Show resolved Hide resolved
docs/hub/repositories-getting-started.md Show resolved Hide resolved
docs/hub/index.md Outdated Show resolved Hide resolved
docs/hub/index.md Outdated Show resolved Hide resolved
docs/hub/index.md Outdated Show resolved Hide resolved
docs/hub/repositories-pull-requests-discussions.md Outdated Show resolved Hide resolved
docs/hub/repositories-pull-requests-advanced.md Outdated Show resolved Hide resolved
docs/hub/repositories-next-steps.md Outdated Show resolved Hide resolved
Comment on lines +74 to 76
* Add the type to `PipelineType`. Note that pipeline types are sorted into different categories (NLP, Audio, Computer Vision, and others).
* Specify the task color in `PIPELINE_COLOR`.
* Specify the display order in `PIPELINE_TAGS_DISPLAY_ORDER`.
Copy link
Member

Choose a reason for hiding this comment

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

I think this is outdated cc @osanseviero

docs/hub/datasets-gated.md Outdated Show resolved Hide resolved
@NimaBoscarino NimaBoscarino merged commit 929d86a into main Jun 1, 2022
@NimaBoscarino NimaBoscarino deleted the docs-revamp branch June 1, 2022 13:48
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.

8 participants