move declarations to header file
extend README