wow, almost lost it
update typos
add a missing title
explaining a bit descriptors + decorators