1. add basic descriptions
1. add ref to simulator