Provide diff with all changes in step-by-step example.

[BenjaminRodenberg]

I just prepared this for my thesis and thought it might also be useful for the documentation. It's unfortunately quite lenghty, but there are also many changes. I'm open for suggestions!

Todo

• Split code block. See 74e377c. @uekerman , @fsimonis any guidelines? Does not look critical to me. We can also fix this later, if necessary.

[uekerman]

I like this idea. My suggestion would be to move this code part at the bottom and explain all individual steps one-by-one above (not in this PR).

No idea about the code split. Seems like we should do this.

[MakisH]

Related to #260

[fsimonis]

Can't we changes these to std::vector now?

[MakisH]

Looks really nice, and very helpful, thank you!
I have not cross-checked with the latest state of the API, but the changes make sense compared to what I remember from the last time I checked.

[BenjaminRodenberg]

@MakisH Do you have more details on this point? If it is simple: Let's do it now. If it is more complicated: I guess it's not critical and we can just merge.

[MakisH]

I do not understand what you mean. Could you please elaborate what the problem is? I vaguely remember some issue with code highlighting in diff. Normal diff should work.

[BenjaminRodenberg]

According to 74e377c there seems to be some issue with longer code blocks. But let's not worry about it here. I'll open an issue, because we should probably discuss this with @chlorenz and add some general information and guidelines somewhere in the documentation for the documentation.