document number encoding
add contributing chapter