a bit more context documentation