add conventions and engineering notes