update documentation & add a bit of Ubuntu support