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 rehaul for v0.8 #242

Merged
merged 5 commits into from
Jun 6, 2023
Merged

Docs rehaul for v0.8 #242

merged 5 commits into from
Jun 6, 2023

Conversation

theabhirath
Copy link
Member

This is the last PR for v0.8, and introduces just about enough documentation to ensure that users can find their way around the major parts of the repo. A large swathe of the builders remain undocumented, but that will take time and effort and I would rather get v0.8 out first and then worry about that.

cc @darsnack for suggestions in case something important has been missed.

@theabhirath theabhirath added this to the 0.8 milestone Jun 4, 2023
@theabhirath theabhirath self-assigned this Jun 4, 2023
@theabhirath theabhirath requested a review from darsnack June 4, 2023 16:04
@theabhirath theabhirath linked an issue Jun 4, 2023 that may be closed by this pull request
@theabhirath theabhirath added the documentation Documentation label Jun 4, 2023
@github-actions
Copy link
Contributor

github-actions bot commented Jun 4, 2023

Once the documentation build has completed, you can preview any updated documentation at this URL: https://fluxml.ai/Metalhead.jl/previews/PR242/

Signed-off-by: Abhirath Anand <74202102+theabhirath@users.noreply.github.com>
Signed-off-by: Abhirath Anand <74202102+theabhirath@users.noreply.github.com>
Signed-off-by: Abhirath Anand <74202102+theabhirath@users.noreply.github.com>
@CarloLucibello
Copy link
Member

We should disallow loading densenet pretrained weights and mark the weight as not available in the docs.

Signed-off-by: Abhirath Anand <74202102+theabhirath@users.noreply.github.com>
Copy link
Member

@darsnack darsnack left a comment

Choose a reason for hiding this comment

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

Looks pretty good to me!

Other details that I cannot directly comment on:

  • The DenseNet docstring has the "Arguments" bullet list indented which is being interpreted as a markdown code block
  • The UNet docstring has the same issue as DenseNet
  • The MLPMixer + ResMLP docstring should list the config types as symbols (i.e. :small, :base, etc.)

docs/src/howto/resnet.md Outdated Show resolved Hide resolved
docs/src/howto/resnet.md Outdated Show resolved Hide resolved
docs/src/api/utilities.md Show resolved Hide resolved
@darsnack
Copy link
Member

darsnack commented Jun 5, 2023

Also need to remove DenseNet from the pretrained models list in test.

Also commented out DenseNet pretrained tests for now

Co-Authored-By: Kyle Daruwalla <daruwal@cshl.edu>
@theabhirath
Copy link
Member Author

Done, done, done and done! Hopefully tests pass, and then we can finally release this 😁. I have a ready blog post for the Flux website detailing the major improvements as well, so I can land that PR after we tag 😊.

@theabhirath theabhirath requested a review from darsnack June 5, 2023 16:26
Copy link
Member

@darsnack darsnack left a comment

Choose a reason for hiding this comment

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

Amazing, thanks!

@theabhirath theabhirath merged commit ec27452 into master Jun 6, 2023
@theabhirath
Copy link
Member Author

Can I go ahead and tag v0.8 now?

@darsnack
Copy link
Member

darsnack commented Jun 6, 2023

Yeah go for it

@theabhirath theabhirath deleted the a2/docs-rehaul-1 branch June 6, 2023 15:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Release v0.8
3 participants