Fix several wrong linkages

A number of changes were done to fix issues arising in the build of the user guide.

Several links were broken or not updated.

A conda environment with the required set of packages was create to help out users.

requested review from @acoward

assigned to @tlovato

approved this merge request

mentioned in commit e30b912c

merged

changed milestone to %2022 WP