What do with examples/ ?

[ViralBShah]

Currently, our examples are a collection of various things. This was useful in the early days when we had not much of a website, not much of a manual, no blog posts, and most importantly, no packages.

I would prefer to get rid of examples altogether by absorbing the useful parts in base, and move the rest into packages, or delete altogether.

For the examples that are truly meant to be teaching tools, they may be better off as ipython notebooks which explain different concepts and allow users to experiment, change things, run again, etc.

[JeffBezanson]

I don't find anything offensive about a directory of 20 little files.
This is also #2598.

[ViralBShah]

I do like to think that there should be a good reason for things to be included and distributed. I prefer removing things unless there is a good reason to have them there.

I'll move this into #2598. I forgot that it was still open.

[StefanKarpinski]

Yeah, I don't really see the problem with the examples directory. Maybe we can get rid of some of them that are less relevant, but I think the directory can stay. It would be nice to hook examples into the tests so that we don't accidentally break them.

[ViralBShah]

That is my point. Make the examples useful (with comments or refer to them in the docs), make sure they run in tests, keep them updated etc. I don't mind keeping the examples/ directory if we go down that path. Anyways, let's continue this in #2598.

[timholy]

Off-topic, but is there any interest in expanding the examples? I submitted a PR to https://github.com/andrioni/Quaternions.jl recently, not realizing it was based on something in examples/.