move hardcoded numbers, etc. into soc files. create headers for shared types which needs to be documented. (MINOR CHANGE)