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

Reordering the tutorials? #270

Open
ParadaCarleton opened this issue Aug 19, 2021 · 8 comments
Open

Reordering the tutorials? #270

ParadaCarleton opened this issue Aug 19, 2021 · 8 comments

Comments

@ParadaCarleton
Copy link
Member

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:

  1. Introduction
  2. Linear regression
  3. Logistic regression
  4. Multinomial regression
  5. Poisson regression
  6. Gaussian mixture model
  7. Infinite mixture model
  8. Variational inference
  9. Bayesian neural networks
  10. Bayesian differential equations
  11. 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.

@cpfiffer
Copy link
Member

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.

@ParadaCarleton
Copy link
Member Author

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?

@cpfiffer
Copy link
Member

Sure, why not? I'm open to a PR.

@ParadaCarleton
Copy link
Member Author

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.

@rikhuijzer
Copy link
Contributor

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.

@rikhuijzer
Copy link
Contributor

Oh sorry. Turing isn’t using Franklin. Then, just place the correct redirect files at the right places, I guess

@ParadaCarleton
Copy link
Member Author

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?

@KronosTheLate
Copy link

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.

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

4 participants