interface type best practices

[naxos]

Is there anyone with a good (and simple) example on how to use the interface type to setup a network (ip address, gateways, netmasks, vlans)
using puppet (under a debian) installation?

This is all I can find and doesn't help too much to be honest:
http://docs.puppetlabs.com/references/2.7.0/type.html#interface

Or is there any other puppet solution to this?

Thanks and cheers