Document the responsibility of NetworkInterfaces.
Use @attribute, don't misuse @example.
Merge pull request #271 from mvidner/doc-networkinterfaces

Document the responsibility of NetworkInterfaces.