Doc: more polishing

- add description of syncing limitations
- update out-of-date comments

Fixes #788