=str write intro to docs

NOT YET CORRECTLY LINKED
are the "typically Xans" any help here?