improve doc and add a brainstorm section