rename to make urls nicer
add pages documenting other issues