improved documentation

- added an example error to alignace.md