update Permalink
update Readme / Comments
add known issue about RealURL vs type on the AdW site to Readme
fix typos in Readme