[wix-devs] documentation for WiX v4

[Blair Murri]

Not everyone uses Votive, but I still prefer the .chm. You also know that the docs you're reading pertain to what your building against, instead of that next version you can't (for whatever reason) upgrade to.

One option would be to split the .chm apart so that each extension would have its own, and the content containing the wix.xsd would be in the same nuget package as the core tools.

That way, any change anywhere only requires at minimum two repos to be rebuilt: the one that ships the .chm, and web.

Get Outlook for Android<https://aka.ms/ghei36>

________________________________
From: wix-devs <wix-devs-bounces at lists.wixtoolset.org> on behalf of Rob Mensching via wix-devs <wix-devs at lists.wixtoolset.org>
Sent: Wednesday, February 6, 2019 8:47:06 AM
To: WiX Toolset Developer Mailing List
Cc: Rob Mensching
Subject: Re: [wix-devs] documentation for WiX v4

We have not created that repo over yet but should.

Currently the wix.xsd (that generates the bulk of the documentation) exists in the Data repo. Nothing happens to it there (it isn't used for anything but documentation purposes at this point) so I don't think this is the right place for it. That leads to a few questions:

1. Should we create a "Documentation" or "Doc" repo and move the .xsd and the .chm build to that repo?

2. Should we bother creating the .chm documentation and instead move everything to the web?

3. If we keep the .chm, where should we ship it? With Votive? That's the only thing that really has UI any more.

4. The .xsd needs to eventually make its way to the `VisualStudioExtension" (aka: Votive) repo. (I know, not a question)


Thinking out loud: If we get rid of the .chm (something I'm basically good with) then the handwritten content probably all moves to the "Web" repo. That means we'd need to figure out where the wix.xsd should live and how to generate its web content form (maybe share the wix.xsd with "Web" repo and let the Web repo build take care of generating the html doc).

Any opinions?

-----Original Message-----
From: wix-devs <wix-devs-bounces at lists.wixtoolset.org> On Behalf Of Sean Farrow via wix-devs
Sent: Sunday, February 3, 2019 6:26 AM
To: WiX Toolset Developer Mailing List <wix-devs at lists.wixtoolset.org>
Cc: Sean Farrow <sean.farrow at seanfarrow.co.uk>
Subject: [wix-devs] documentation for WiX v4

Hi,

I was just wondering in which repository the documentation lives for WiX v4?

Kind regards
Sean.
____________________________________________________________________
WiX Toolset Developer Mailing List provided by FireGiant http://www.firegiant.com/
____________________________________________________________________
WiX Toolset Developer Mailing List provided by FireGiant http://www.firegiant.com/