Fix documentation for south
Document the description size rationale
Merge pull request #3708 from yakky/feature/south

Fix documentation for south
Merge pull request #3710 from yakky/fix/doc_title

Document the description size rationale
Fix #3673