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

[Docs] Restructure doc page and add AI gallery #3331

Merged
merged 61 commits into from
Mar 26, 2024
Merged

Conversation

Michaelvll
Copy link
Collaborator

@Michaelvll Michaelvll commented Mar 19, 2024

Find the latest doc for this PR at: https://skypilot.readthedocs.io/en/docs-with-gallery-2/docs/index.html

TODO:

  • Add docs for TGI
  • Improve the doc for axolotl

Future TODOs:

  • axolotl docs
  • ray docs
  • vision models
  • Inline yaml files in the docs

Tested (run the relevant ones):

  • Code formatting: bash format.sh
  • Any manual or new tests for this PR (please specify below)
  • All smoke tests: pytest tests/test_smoke.py
  • Relevant individual smoke tests: pytest tests/test_smoke.py::test_fill_in_the_name
  • Backward compatibility tests: bash tests/backward_comaptibility_tests.sh

@Michaelvll Michaelvll marked this pull request as ready for review March 19, 2024 07:30
Copy link
Member

@concretevitamin concretevitamin left a comment

Choose a reason for hiding this comment

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

Awesome @Michaelvll! Did a pass.

Is it possible to make the hover underline show up in the same position as an active tab's underline?
Screen Shot 2024-03-24 at 10 23 49
Otherwise feels a bit weird.


Shall we consider adding a "New" button in the AI Gallery tab?

docs/source/_gallery_original/index.rst Outdated Show resolved Hide resolved
docs/source/_gallery_original/index.rst Outdated Show resolved Hide resolved
docs/source/_gallery_original/index.rst Outdated Show resolved Hide resolved
docs/source/_gallery_original/index.rst Outdated Show resolved Hide resolved
docs/source/_gallery_original/index.rst Outdated Show resolved Hide resolved
docs/source/index.rst Outdated Show resolved Hide resolved
docs/source/prepare_github_markdown.py Show resolved Hide resolved
llm/codellama/README.md Outdated Show resolved Hide resolved
llm/codellama/README.md Show resolved Hide resolved
llm/tgi/README.md Outdated Show resolved Hide resolved
Michaelvll and others added 9 commits March 24, 2024 23:59
Co-authored-by: Zongheng Yang <zongheng.y@gmail.com>
Co-authored-by: Zongheng Yang <zongheng.y@gmail.com>
Co-authored-by: Zongheng Yang <zongheng.y@gmail.com>
Co-authored-by: Zongheng Yang <zongheng.y@gmail.com>
Co-authored-by: Zongheng Yang <zongheng.y@gmail.com>
@concretevitamin
Copy link
Member

concretevitamin commented Mar 25, 2024

Checked out the latest top nav bar hover behavior. The hover underline "connects" to an active tab's underline, which is a bit unusual. Maybe there's another aesthetic to use there? E.g.,

  • remove underline for both hover and active?
  • hover shows underline, but active doesn't (active would still show font color change etc. so maybe ok to distinguish)

Copy link
Member

@concretevitamin concretevitamin left a comment

Choose a reason for hiding this comment

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

LGTM, thanks @Michaelvll!

Final Q:

Shall we consider adding a "New" button in the AI Gallery tab?

Mainly to check how it looks.


Readers can directly execute the SkyPilot YAMLs on their own infrastructure, such as cloud VMs or Kubernetes.

.. image:: https://imgur.com/oHPjeCi.png
.. image:: https://imgur.com/POFdmiEx.png
Copy link
Member

Choose a reason for hiding this comment

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

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Oops, added it to our own images/ folder now. Thanks!

@@ -55,7 +55,7 @@ We welcome contributions from the community. If you would like to contribute, pl

1. Fork the `SkyPilot repository <https://github.com/skypilot-org/skypilot>`__ on GitHub.
2. Create a new folder for your own framework, LLM model, or tutorial under `llm/ <https://github.com/skypilot-org/skypilot/tree/master/llm>`__.
3. Add a README.md, a SkyPilot YAML, and other necessary files to run the AI project.
3. Add a README.md, a SkyPilot YAML, and other necessary files to run the AI project. (Relative paths are not supported. Please use GitHub URLs for the references to the files.)
Copy link
Member

Choose a reason for hiding this comment

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

Was thinking this hint can exist ~L16 as a comment for reviewers to pay attention to. To make this section shorter.

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Sounds good! Added the comment instead.

@Michaelvll
Copy link
Collaborator Author

LGTM, thanks @Michaelvll!

Final Q:

Shall we consider adding a "New" button in the AI Gallery tab?

Mainly to check how it looks.

Here is an example of how New item looks in the tab. I found it a bit crowded for the tab. Wdyt?
image

@Michaelvll Michaelvll merged commit de9527d into master Mar 26, 2024
20 checks passed
@Michaelvll Michaelvll deleted the docs-with-gallery-2 branch March 26, 2024 08:46
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.

3 participants