first cut add unifying documentation of codes