clarify software types
misc notes