As you already pointed out, there is need to split up this documentation into several parts. 
Magic commands, for instance, are a general IPython construct and hence, should be placed somewhere else.