update docs for orm file specs