1.5 docs

@odwrotnie Could you review this? Thanks!