Subversion book 301 error [PATCH]

Ben Collins-Sussman sussman at red-bean.com
Tue Mar 29 19:36:51 CST 2005


On Mar 29, 2005, at 5:26 PM, C. Michael Pilato wrote:

>> (Meanwhile, I'm trying to scheme up a way to automatically convert
>> project_faq.html into docbook-xml, so the book can stay in sync!)
>
> On the contrary, I think we should gut that reproduction of the FAQ
> altogether, putting FAQ entries relevant to the book text near the
> relevant book text (as Tips or something), and dropping the rest.

I agree that would be ideal, but I fear it's unscalable.... that we'd 
end up with way too many tips/sidebars/etc, and that it would end up 
destroying the readability of chapters... or maybe just overwhelm the 
reader.

I think that *some* of the FAQs can be incorporated into the book's 
text as normal content, as improvement to existing explanations.  But 
certainly not everything in the FAQ.  It's a losing battle.

I think you're right... we should probably just kill the whole FAQ 
appendix, and merely point to the website.




More information about the svnbook-dev mailing list