InstallationGuide context examples and ampersands

[Anil Gangolli <an...@busybuddha.org>]

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.

Re: InstallationGuide context examples and ampersands

[Anil Gangolli <an...@busybuddha.org>]

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.
>>
>>
>>
>>     
>
>
>   

Re: InstallationGuide context examples and ampersands

[Allen Gilliland <Al...@Sun.COM>]

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.
> 
> 
>