Update with software design specifications

Version 1.0 of design recommendations. Please review, comment and update
as desired.