Fix some markdown and add stuff about joins