supporting local urls and adding bit more docs