fix make distcheck on linux
document number encoding
add contributing chapter
Use our official doc links