add param, allowing an 'includes' array

update readme.md with api for includes