doc: added some function doc
chore: more url changes by martin + me