added more on proposals and a code example