There have been a few infrastructure improvements in the last six months.
First, there was the move to git. Second, there is the new infrastructure for
using xUnit.net testing. Now, I'm cleaning up the help build system because the
web manual hasn't been updated since WiX v3.7 moved to MSBuild. Additionally,
writing documentation is beyond annoying since you have to write in perfect
XHTML.
I've been using DocPad (http://docpad.org/) a lot lately to build static sites
and have been really happy with the functionality there. I'm moving the WiX
toolset site (http://wixtoolset.org/) to DocPad to make it much easier to
update the site. To get the help manual to integrate well with the rest of the
site, the new help system borrows a lot of concepts from DocPad. That's a good
thing as long as you like Markdown. <smile/>
New help content will look like this. Imagine a file:
"src\chm\documents\overview\example.html.md":
---
title: Name in CHM table of contents or title of page on Web.
layout: default
---
# Example Topic H1
This is a paragraph of text that explains stuff.
## Second Header using H2
This is more paragraph text to introduce code example:
<Wix>
<!-- Indenting four spaces means you can just write code! --->
<Feature Title='No & escaping necessary!' />
That's it. The same thing in current XHTML documentation is much longer and
much harder to read and XML code snippets are horrible to write.
Ultimately, my hope is that this further reduces the friction to writing and
updating documentation so people will just go in and do it. If nothing else,
the new system will get the web site content updated and it will work well
together. Updating the current http://wix.sf.net/ site is a bunch of layered
hacks.
I hope to have my pull request coming soon that shows how it'll all work very
soon.
Questions, comments and feedback?
------------------------------------------------------------------------------
This SF.net email is sponsored by Windows:
Build for Windows Store.
http://p.sf.net/sfu/windows-dev2dev
_______________________________________________
WiX-devs mailing list
WiX-devs@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/wix-devs
