=str write intro to docs

NOT YET CORRECTLY LINKED
I don't think it is true though.