Chore: cleanup specs, minor renaming and restore warning when doc assets is missing