update documentation and refine the creation of assembly scripts