writing the full docs