<br><div class="gmail_quote"><blockquote class="gmail_quote" style="margin: 0pt 0pt 0pt 0.8ex; border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;">
1) Two places containing the API reference.<br>
<br>
In your example documentation the API reference is included in one of<br>
the chapters. Wouldn&#39;t it be better to just have it in one place - the<br>
Haddock docs?
 <br></blockquote><div><br>The example is just a test of how you could create a full-customizable 
single document which includes the Haddock reference. Of course, the 
idea is that you could create documentation without any Haddock render 
directive (but keeping the cross references) and then, you could enable 
the attachment Haddock reference in the same document or in another 
document.<br> </div><blockquote class="gmail_quote" style="margin: 0pt 0pt 0pt 0.8ex; border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;">
2) Integration with Haddock docs.<br>
<br>
I think it would be best if the pages generated by this system and the<br>
pages generated by Haddock would be integrated as much as possible -<br>
both style wise (sharing CSS, structure, headers, footers, sidebars<br>
etc) and also in terms of hyper linking. Identifiers in your<br>
documentation should go to the Haddock docs. It should feel as if the<br>
Haddock pages are just a part of the whole documentation structure. <br></blockquote><div><br>I agree, and I tried to represent that in the example (but I created a 
new css). All the documentation will be rendered by Pandoc so there is 
no difference between the format of each side. I also think it would be 
interesting to be able to refer to parts of the documentation from 
Haddock, but keeping the Haddock format <span class="short_text" id="wwyv"><font><span style="background-color: rgb(255, 255, 255);">(This
 is not shown in the example)</span></font></span>.<br> </div><blockquote class="gmail_quote" style="margin: 0pt 0pt 0pt 0.8ex; border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;">
3) Configuration<br>
<br>
I haven&#39;t looked at this yet but I suspect people will not want<br>
another configuration file in their projects. Perhaps you could<br>
propose some kind of Cabal integration instead.<font color="#888888"><br>
</font></blockquote></div><br>That would be awesome. I have to see how Cabal handles these files.<br><br>