link section update
missing Propel code updated

added missing yaml definitions for behaviors and inheritance, fixed
errors and formatting
smallish markdown code cleanup