little improvement and large documentation for JSONArray class