updated intro text and added query examples
fixes for FAQ