[wix-devs] documentation for WiX v4

[Hoover, Jacob]

I’m not opposed to splitting the chm’s but I would hate to loose a global index with at least a reference to “see this” chm.

Sent from my iPhone

> On Feb 6, 2019, at 11:33 PM, Blair Murri via wix-devs <wix-devs at lists.wixtoolset.org> wrote:
> 
> 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/
> ____________________________________________________________________
> WiX Toolset Developer Mailing List provided by FireGiant http://www.firegiant.com/
> NOTE: This email was received from an external source. Please use caution when opening links or attachments in the message.