The methods of class `Network` need to be better documented

[fwitte]

Some are missing docstrings, some are not straight forward to understand from their name and the user variables. Docstrings and comments should be added, maybe improved naming scheme might be useful.