sync methodology document with upstream updates