cleaning up the odm documentation

| Q   | A
| --- | ---
| Doc fix? | yes
| New docs? | yes
| Applies to | dev
| Fixed tickets | #470, #426

glad for content feedback. i did not write much new content, mostly split the content and removed some redundancy.