Light check over all scarpet docs Resolves #1626, resolves #1613, resolves #1597, some of the fixes are from these
