docs
docs copied to clipboard
TuringLang
Reordering the tutorials?
Looking at the tutorials, the ordering looks a bit random. Perhaps we should reorder the tutorials, roughly in order from least to most advanced, to make it easier to understand them? I'd suggest something like:
- Introduction
- Linear regression
- Logistic regression
- Multinomial regression
- Poisson regression
- Gaussian mixture model
- Infinite mixture model
- Variational inference
- Bayesian neural networks
- Bayesian differential equations
- Hidden Markov models
So the order goes from easy to difficult; this order also keeps generalized models together with their more specific instances (e.g. logistic regression is followed by multinomial regression).
I can make the PR if you guys are interested.
Yep, I like that ordering. Currently they're just organized in the order that they were written, which is not super great as you've noted.
The big issue here is that moving everything around will break all the old links to these tutorials, which isn't super great. I'm kind of tilting towards not rearranging them for just that reason, but I'm very open to being persuaded.
Yep, I like that ordering. Currently they're just organized in the order that they were written, which is not super great as you've noted.
The big issue here is that moving everything around will break all the old links to these tutorials, which isn't super great. I'm kind of tilting towards not rearranging them for just that reason, but I'm very open to being persuaded.
Perhaps we could redirect the old links to the new links, and remove the numbers from the link so this won't be a problem in the future?
Sure, why not? I'm open to a PR.
Cool, I'll make a PR here; do you know who usually handles the JS and such for the website and could get a redirect link working? I don't know how to do web dev.
Cool, I'll make a PR here; do you know who usually handles the JS and such for the website and could get a redirect link working?
You need to figure out how people do it in Franklin.jl. Redirects are a native HTML construct, by the way, not Javascript per se.
Oh sorry. Turing isn’t using Franklin. Then, just place the correct redirect files at the right places, I guess
Oh sorry. Turing isn’t using Franklin. Then, just place the correct redirect files at the right places, I guess
What would those places be?
Big +1 on reordering the tutorials - as a newcomer, the current order is indeed confusing. Worse than that, it starts with subjects that sound daunting to me, killing the "let's start at the beginning and learn this stuff!" feeling/motivation right away.
@yebai It just need updating _quarto.yml, Is it fine to rename them as you were saying no to restructure the file organization previously?
I can either rename the files and update _quarto.yml or else reorganize whole file structure of docs like this: All this in docs repo, using-turing, tutorials, contributing & for-developers folders in root directory: ├───using-turing │ ├───getting-started │ ├───more... ├───for-developers │ ├───abstractmcmc-turing │ ├───more... ├───tutorials │ ├───bayesian-differential-equations │ ├───more... ├───contributing │ ├───contributing-guide │ └───contributing-style-guide
More consideration is required to reorganise the docs; let’s reorder them for now.
Introduction
Linear regression
Logistic regression
Multinomial regression
Poisson regression
Gaussian mixture model
Infinite mixture model
Variational inference
Bayesian neural networks
Bayesian differential equations
Hidden Markov models
Is this sequence correct? and what about these:
- probabilistic-pca
- gplvm
- seasonal-time-series
- minituring
- gaussian-processes
and also get-started/using-turing section's sequence is correct? also for developers section!
- @yebai It will of great help if you provide the sequence!