Update the README

[rlouf]

This PR updates the README to get the repo ready for release, and adds two example notebooks:

• Update README
• Add example that showcases "uncertainty"
• Add simulation-based inference notebook

[brandonwillard]

I've added some comments, but they shouldn't block merging this.

[zaqqwerty]

Great content here! In the notebooks, could it make sense to call out places where outlines is used more explicitly? Perhaps with a brief explanation of how Outlines is simpler than other ways one might accomplish the task

[rlouf]

could it make sense to call out places where outlines is used more explicitly?

Not sure how I could make it more explicit than calling functions from outlines. Do you mean spelling it out "We use xxx from the library to do xxx"?

Perhaps with a brief explanation of how Outlines is simpler than other ways one might accomplish the task

I think the code speaks for itself. At least it should, otherwise we have a problem. If you want a comparison it'd be better to do a side-by-side comparison in another notebook imo.

[zaqqwerty]

Yeah I thought it would be useful to add spelling out sentences like that. For the comparison piece I just mean less than a sentence hinting at what you might need to do if you had python but no Outlines library to help out.

[farice]

Woo!

[rlouf]

Yeah I thought it would be useful to add spelling out sentences like that. For the comparison piece I just mean less than a sentence hinting at what you might need to do if you had python but no Outlines library to help out.

Ok I'll add a few sentences.