Better docs for sets and intsets

[narimiran]

(do not squash when merging)

[alehander92]

this should be a part of the style guide, but can we have an empty line between examples and code? it seems harder to separate them that way IMO , even with the indent

[narimiran]

can we have an empty line between examples and code? it seems harder to separate them that way IMO , even with the indent

For my personal projects, I use 4-space indentation for runnableExamples, which IMO makes separation much clearer. But I know that @Araq once said he doesn't want that style in stdlib. (Maybe he changed his mind in the mean time?)

When it comes to an empty line between, I'm not sure. When function body is just oneliner, and the space between functions is also one line, it makes stuff even worse, readability-wise.

[alehander92]

I don't agree: usually examples are longer than short functions, and I feel having them separated helps noticing where the actual function begins: but this is subjective!

[Araq]

Sorry about the squash.