Documentation incorrect

[wixbot]

The instructions for "Creating a Simple Setup" are wrong. http://wixtoolset.org/documentation/manual/v3/votive/authoring_first_votive_project.html

Step 2:

1. Click File, then click New, then click Project.

Don't do this. Should read.

1. Right click the Solution, Select Add then select New Project

Instruction 6 should also point people to the comment on line 24 in the code:

"TODO: Remove the comments around this Component element and the ComponentRef below in order to add resources to this installer."

as a newbie will not see it because they are following the instructions.

Originally opened by richard210363

[wixbot]

Area changed from settings to wixtoolset.org
Release changed from v3.9 to v3.x

[aplocher]

I ran into this again today. Of course it's easy enough to fix, but is there a reason the documentation doesn't just get fixed to accurately reflect a basic "getting started" scenario in VS - from beginning to end? It has been wrong for 3+ years now.

I'm sure this is the go-to tutorial for any new WiX / VS user. Any ambiguity should be addressed IMO.

If you follow the documentation word-for-word, you will end up with a build error

Error The ComponentGroup element contains an unexpected child element 'File'. MySetup

Here's my recommendation for step 6 (I'm sure it could be written much better, but I think it's an improvement over what is there currently):

6. Find the comments for the Component and uncomment them (also remove the first "TODO"), so it will look like:

   ...
   <ComponentGroup Id="ProductComponents" Directory="INSTALLFOLDER">
   <Component Id="ProductComponent">
   <!-- TODO: Insert files, registry keys, and other resources here. -->
   </Component>
   </ComponentGroup>
   ...
   
   

   Then replace the remaining TODO in between the Component tags, with:

   <File Source="$(var.MyApplication.TargetPath)" />

[aplocher]

Also, might be good to mention something about providing a value for the Manufacturer attribute, because the next build error the user will receive is:

Error The Product/@Manufacturer attribute's value cannot be an empty string. If a value is not required, simply remove the entire attribute.

[barnson]

The bug is open for anyone to fix. Would you submit a pull request?