update documentation + add sample