add us_portland
update syntax, hyperlinks