More gaApi improvements, added some notes and comments

More gaApi improvements, added some notes and comments
Prettyfied