update URLs
switch to temp URLs while others aren't working
remove obsolete doc notes; add links to updated API docs
add note about being out of date + link to more up to date info
add frank's questions from #4
fix ticket reference
initial API draft from #4