fix 404'ing section link
add small grammar change
fix typos and use 'we'
make argument order more clear