Comments (5)
Yeah, this is a fair criticism.
cc @EssamWisam
from mlj.jl.
@schlichtanders
Sorry if this came a little late. Yes, it's straightforward but we are possibly planning (in the short-term) for other big changes for the documentation/landing page and this or something just as convenient will be one of them.
Until we get to work on that (hopefully soon), I highly recommend that you rely on the categorization found in the homepage of the documentation which should be easy to navigate and understand.
from mlj.jl.
Any plans?
I really feel hesitant recommending MLJ to others new to Julia because of this.
I know that MLJ is the most complete and best maintained julia meta package for machine learning, but still people just expect that they can go to the documentation and are guided instead of overwhelmed.
from mlj.jl.
I just saw that the MLJ Home already includes the additional nesting.
https://alan-turing-institute.github.io/MLJ.jl/dev/#Reference-Manual
It should be relatively straightforward to include this extra nesting also in the left menu tree. This would be soo much better :)
from mlj.jl.
Just a note that the grouping of topics on the landing page (not the left menu) are not a strict hierarchy, as the same topic can appear under multiple headings. I'm not wedded to this idea but I do find it personally useful. For example, in MLJ, tuning is a model wrapper, so naturally appears under "Composition". But this may be a novelty for new users, who may be more likely to find it under "Meta-algorithms".
I wonder if (in addition to adding a heirarchy) we can mitigate the overwhelming experience reported by funnelling new users more aggressively to the "Learn MLJ" page (which has a small link at the top at present). So, on the landing page there could be just 4 very large prominent options:
INSTALL
LEARN
REFERENCE
MODEL BROWSER
Just brainstorming here. Thoughts?
from mlj.jl.
Related Issues (20)
- Confusing Julia code in adding_models_for_general_use.md HOT 1
- Include MLJBalancing.jl in MLJ and re-export it's names.
- Update docs for new class imbalance support
- Add new sk-learn models to the docs
- Export the name `MLJFlow` HOT 1
- `evaluate` errors HOT 3
- Add AutoEncoderMLJ model (part of BetaML) HOT 10
- need a tutorial for using logger with dagshub and mlflow HOT 4
- Document how to add plot recipes in a new model implementation HOT 4
- Add new model descriptors to fix doc-generation fail HOT 1
- Models that fail integration tests but defy isolation
- Update list of BetaML models HOT 1
- Reinstate CatBoost integraton test
- Upate ROADMAP.md HOT 1
- Include support for MixedModels.jl HOT 2
- Deserialisation fails for wrappers like `TunedModel` when atomic model overloads `save/restore` HOT 2
- feature_importances for Pipeline including XGBoost don't work HOT 2
- Current performance evaluation objects, recently added to TunedModel histories, are too big HOT 2
- Update cheat sheet instance of depracated `@from_network` code
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from mlj.jl.