new reference, requirements and README