Indeed I still support that position in general, but in this particular
case, I'm only arguing a much less radical step, namely to remove the
inline copies of the context xml files from the wiki page, and just
refer to the downloadable attachments. This only affects the
InstallationGuide page(s) of the wiki.
--a.
Allen Gilliland wrote:
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.
