better asset handling and docs update