I agree with Anil. I think we should ditch the wiki based guides and replace them with static files which are maintained in svn and are packaged with each release. I thought we had said something about how the OO doc could be exported to html right?
-- Allen On Sun, 2006-01-22 at 09:11, Anil Gangolli wrote: > Every time I edit the InstallationGuide pages I either screw up the > & entities in the context.xml examples or find that someone else > has. It really makes it a pain to edit either of these pages. > > This time it was me; editing with Firefox 1.5. I was eventually able to > get the & entities corrected after switching to IE and trying a few > different alternatives. Not sure exactly which combination worked. The > behavior appears to differ if you preview or not. If you preview and > then hit Keep Editing rather than back, your & may become an &, > despite what you saw in the preview. You'll see about 3 different > versions in the wiki change log as I fumble with this. > > The issues with & treatment in browsers can bite both when we edit > this page (whether you touch these portions or not), and apparently also > at times when users cut and paste from the page. > > Long ago I attached downloadable versions of these files in order to try > to avoid issues related to browsers interpreting the & entities, and > added a recommendation that people use them. By my own informal > reckoning, this did indeed cut down on the number of issues related to > incorrect ampersands in URLs. > > At this point I'd like to suggest that we go entirely with the > downloadable versions of these files and drop the inline versions from > the wiki page. For my part, I'm very reluctant to spend any more of my > time fixing & signs on the wiki anymore. > > Frustrated, > --a. > > >
