add more documentation about vendors and platforms