For the install from windows source (https://magick.imagemagick.org/script/i ... hp#windows
), I recommend the following changes, all in the spirit of encouraging the non-expert to not give up too soon (I almost did).
1) Directly under the section header "Install from Windows Source" I think it is appropriate to say something like:
"We recommend you first uninstall an existing ImageMagick, else you might be surprised that your magick/convert commands go to the old version."
2) Current: "Building ImageMagick source for Windows requires a modern version of Microsoft Visual Studio IDE"
Suggested: "Building ImageMagick source for Windows requires a modern version of Microsoft Visual Studio IDE (free)"
3) Current: "Clone the Github repo:" .... Alternatively download ImageMagick-windows.zip ....
Suggested: "Method 1: Clone the Github repo:" .... <p>Method 2: download ImageMagick-windows.zip ...
4) Before "Next, launch" suggest adding "Unzip in a folder that does not need Admin permissions, otherwise Visual Studio will not be able to build the solution." [Learned this the hard way]
5) Current: " and press Open"
Suggested: " and press Open configure.sln"
Rationale: I first chose "configure.vcxproj" because it looked like a project! And lost 45 minutes backtracking.
6) Remove the sentence containing "If you are using the Visual Studio 6.0 IDE...." since we are at V 16.
7) Before the line "For a more comprehensive test"
suggest adding "You may want to add the full path to VisualMagick\bin for your environment PATH variable, so you can call Magick/convert from any directory."
That's it! Like I said, gives the non-expert a clearer set of directions.