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

Website / doc improvements to improve user experience #60

Open
7 of 16 tasks
ViralBShah opened this issue Jun 5, 2020 · 6 comments
Open
7 of 16 tasks

Website / doc improvements to improve user experience #60

ViralBShah opened this issue Jun 5, 2020 · 6 comments

Comments

@ViralBShah
Copy link
Member

ViralBShah commented Jun 5, 2020

  • Update Features and Ecosystems - Remove some of the older ones
  • Update all the GPU links
  • Separate section: Showcase community projects that have the common models - GeometricFlux, Flux3D, MetalHead, ObjectDetector.jl, Transformers.jl, SciML (DiffEqFlux), TextAnalysis
  • Separate section: Showcase some more research-y things that are end applications - Yao, RayTracer, ...
  • Deployment - with PackageCompiler. We know this won't work - but figure out where it breaks and file relevant issues.
  • Blog: Can we link to other blogs that are not written by us? Aggregation example: JuliaGPU.
  • Have a table of all available models. Could be model zoo (where you cut and paste) or complete models that you can import (MetalHead). Should this be a table, where models are listed as rows, and then level of availability is checkboxes in columns?
  • Observe some first time users, see where they fall, and make sure we have a quickstart or an FAQ to address common issues
  • Update partners. Add CMU, maybe others.
  • Performance comparisons with PyTorch and TensorFlow. This should be front and center, and we should not be shy about admitting where work needs to be done. This will help address the perception that Flux is slow.
  • How can people contribute - improvements, new models, new models with weights. Document that.
  • Docs probably need to be organized for end users and for model builders. Model builders may need to have more information on GPU dev. Common gotchas (like scalar indexing), etc.
  • Link all the users of Flux packages: https://juliahub.com/ui/Packages/Flux/QdkVy/0.10.4?t=2 There's the laundry list, but perhaps some can also be classified into domains.
  • What should users install? Torch.jl is optional - so publish blog and mention in docs, etc.
  • Papers
  • Add JuliaAcademy link
@MikeInnes
Copy link
Member

FluxML/Flux.jl#1204 for updates to CUDA references in the docs.

@MikeInnes
Copy link
Member

MikeInnes commented Jun 10, 2020

Some progress on listing models and the ecosystem here (not yet linked, we just need to add the trained models table).

@ViralBShah
Copy link
Member Author

We probably need a section for papers.

@darsnack
Copy link
Member

I just wanted to bring https://github.com/JuliaCommunity/ML-Coordination-Tracker to attention. We should reference this somewhere (e.g. a contributing section). There's also an MLH fellow helping us out with one of the community projects which should address at least two of the checkboxes above.

  • Available models: the MLH fellow is working on FluxModels.jl which is an effort to provide a single point of access for standard models across various domains
  • Performance comparison: once we have some models up and running in FluxModels.jl, we are planning on creating a repo similar to DiffEqBenchmarks. This will have performance comparisons against PyTorch and TF. And the Julia implementations can serve as regression tests if we integrate with @dhairyagandhi96 's bot.

We're planning on discussing the above plus other efforts in the next weekly call. But I thought I'd mention it here briefly since it is relevant to the website changes.

@MikeInnes
Copy link
Member

Great stuff. I imagine it could be useful to flesh out the 'community' section of the docs with resources like this, and of course specific projects like FluxModels can go on the list I posted above for any of those things. Would be great to have PRs to the right places.

@ViralBShah
Copy link
Member Author

JuliaAcademy link item added to the list above

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

No branches or pull requests

3 participants