FAQ Noise

**dhtml** · Oct 4 '08, 04:45 AM

Re: FAQ Noise

dhtml wrote:

If getting people to read the FAQ is a goal, adding noise doesn't help.
>
I'd like to remove:
>
>
>
| 2.5 How do I direct someone to this FAQ?
|
| This document is posted to clj very frequently. There should be no
| reason to direct someone to it. However, if someone asks a question
| answered in this FAQ or in one of the resources listed herein,
| please let them know their question is answered in the FAQ and that
| the FAQ can be found at http://www.jibbering.com/faq/
|
>
I've never seen this question asked here. Anyone strongly objected to
removing it?

Going...

**Dr J R Stockton** · Oct 4 '08, 03:15 PM

Re: FAQ Noise

On Oct 3, 10:24 pm, dhtml <dhtmlkitc...@g mail.comwrote:

If getting people to read the FAQ is a goal, adding noise doesn't help.
>
I'd like to remove:
>
| 2.5 How do I direct someone to this FAQ?
...

I've never seen this question asked here. Anyone strongly objected to
removing it?

Agreed, but ensure that there are references to the full URL which is,
IIRC,
<http://www.jibbering.c om/faq/index.html: there's one in Section 1.

My main News server currently appears to be accepting uploads but not
propagating them and not supplying articles either. Therefore, my
long reply in another thread has not appeared. I don't fancy
duplicating it via Google, so I'll mail you a copy soon.

--
(c) John Stockton, near London, UK. Posting with Google.
Mail: J.R.""""""""@ph ysics.org or (better) via Home Page at
Web: <URL:http://www.merlyn.demo n.co.uk/>
FAQish topics, acronyms, links, etc.; Date, Delphi, JavaScript, ....|

**dhtml** · Oct 4 '08, 09:15 PM

Re: FAQ Noise

Dr J R Stockton wrote:

On Oct 3, 10:24 pm, dhtml <dhtmlkitc...@g mail.comwrote:

>If getting people to read the FAQ is a goal, adding noise doesn't help.
>>
>I'd like to remove:
>>
>| 2.5 How do I direct someone to this FAQ?
>...

>

>I've never seen this question asked here. Anyone strongly objected to
>removing it?

>
Agreed, but ensure that there are references to the full URL which is,
IIRC,
<http://www.jibbering.c om/faq/index.html: there's one in Section 1.
>

?

I don't understand your response. I propose removing the above cited
(FAQ 2.5) from the FAQ.

My main News server currently appears to be accepting uploads but not
propagating them and not supplying articles either. Therefore, my
long reply in another thread has not appeared. I don't fancy
duplicating it via Google, so I'll mail you a copy soon.

I replied to it. It shows up in my reader, but was not on the list.

Date: 10/3/08 5:47 PM
NNTP Posting Date: Sat, 4 Oct 2008 00:45:36 +0000 (UTC)

Strange. It doesn't appear in GG either. I also explained in that msg
that mail to Bart had been delayed (error message from news server).

Garrett

>
--
(c) John Stockton, near London, UK. Posting with Google.
Mail: J.R.""""""""@ph ysics.org or (better) via Home Page at
Web: <URL:http://www.merlyn.demo n.co.uk/>
FAQish topics, acronyms, links, etc.; Date, Delphi, JavaScript, ....|

**Dr J R Stockton** · Oct 5 '08, 06:45 PM

Re: FAQ Noise

On Oct 4, 5:37 am, dhtml <dhtmlkitc...@g mail.comwrote:

dhtml wrote:

I've never seen this question asked here. Anyone strongly objected to
removing it?

>
Going...

That's rather quick, especially at a weekend. Granted, it's not
irrevocable.

--
(c) John Stockton, near London, UK. Posting with Google.
Mail: J.R.""""""""@ph ysics.org or (better) via Home Page at
Web: <URL:http://www.merlyn.demo n.co.uk/>
FAQish topics, acronyms, links, etc.; Date, Delphi, JavaScript, ....|

**Dr J R Stockton** · Oct 5 '08, 10:05 PM

Re: FAQ Noise

On Oct 4, 10:14 pm, dhtml <dhtmlkitc...@g mail.comwrote:

Dr J R Stockton wrote:
>

On Oct 3, 10:24 pm, dhtml <dhtmlkitc...@g mail.comwrote:

I'd like to remove:

>

| 2.5 How do I direct someone to this FAQ?
...

>

I've never seen this question asked here. Anyone strongly objected to
removing it?

>

Agreed, but ensure that there are references to the full URL which is,
IIRC,
<http://www.jibbering.c om/faq/index.html: there's one in Section 1.

I don't understand your response. I propose removing the above cited
(FAQ 2.5) from the FAQ.

Yes, I agreed, but wanted to stress that the last line, more or less,
is an important statement and something like it must remain
somewhere in the FAQ. In discussion a year or two ago, it was agreed
that the URL in the FAQ should be in full, i.e. with "index.html ".

In Sec 2.3, in a subsection on replying, I suggest something like
"Check the FAQ before replying and cite any part that applies.". We
have often seen bad answers given by those who have not done so.

Strange. It doesn't appear in GG either.

Google was evidently unwell.

--
(c) John Stockton, near London, UK. Posting with Google.
Mail: J.R.""""""""@ph ysics.org or (better) via Home Page at
Web: <URL:http://www.merlyn.demo n.co.uk/>
FAQish topics, acronyms, links, etc.; Date, Delphi, JavaScript, ....|

**dhtml** · Oct 5 '08, 11:15 PM

Re: FAQ Noise

Dr J R Stockton wrote:

On Oct 4, 10:14 pm, dhtml <dhtmlkitc...@g mail.comwrote:

>Dr J R Stockton wrote:
>>

>>On Oct 3, 10:24 pm, dhtml <dhtmlkitc...@g mail.comwrote:

>

>>>I'd like to remove:
>>>| 2.5 How do I direct someone to this FAQ?
>>>...
>>>I've never seen this question asked here. Anyone strongly objected to
>>>removing it?
>>Agreed, but ensure that there are references to the full URL which is,
>>IIRC,
>><http://www.jibbering.c om/faq/index.html: there's one in Section 1.

>
>

>I don't understand your response. I propose removing the above cited
>(FAQ 2.5) from the FAQ.

>
Yes, I agreed, but wanted to stress that the last line, more or less,
is an important statement and something like it must remain
somewhere in the FAQ. In discussion a year or two ago, it was agreed
that the URL in the FAQ should be in full, i.e. with "index.html ".
>

In Sec 2.3, in a subsection on replying, I suggest something like
"Check the FAQ before replying and cite any part that applies.". We
have often seen bad answers given by those who have not done so.
>

Got it. Added a 'Replying' section and moved an item from "How to Ask a
Question":

| Replying
|
| * Quote the minimum of the preceding messages that is
| sufficient to provide context for the reply but trim the remainder,
| and add your comments below the pertinent section of quoted
| material, as per FYI28/RFC1855 http://www.ietf.org/rfc/rfc1855.txt
| (never top post).
|
| * Cite any part of the FAQ that applies. Be specific and link
| to the relevant section.
|
| * Avoid being unnecessarily rude.
|

What do you think?

>
--
(c) John Stockton, near London, UK. Posting with Google.
Mail: J.R.""""""""@ph ysics.org or (better) via Home Page at
Web: <URL:http://www.merlyn.demo n.co.uk/>
FAQish topics, acronyms, links, etc.; Date, Delphi, JavaScript, ....|

**dhtml** · Oct 5 '08, 11:15 PM

Re: FAQ Noise

Dr J R Stockton wrote:

On Oct 4, 5:37 am, dhtml <dhtmlkitc...@g mail.comwrote:

>dhtml wrote:

>

>>I've never seen this question asked here. Anyone strongly objected to
>>removing it?

>Going...

>
That's rather quick, especially at a weekend. Granted, it's not
irrevocable.
>

I can put it back, if it removal seems debatable.

Garrett

--
(c) John Stockton, near London, UK. Posting with Google.
Mail: J.R.""""""""@ph ysics.org or (better) via Home Page at
Web: <URL:http://www.merlyn.demo n.co.uk/>
FAQish topics, acronyms, links, etc.; Date, Delphi, JavaScript, ....|

**Dr J R Stockton** · Oct 6 '08, 03:35 PM

Re: FAQ Noise

On Oct 6, 12:10 am, dhtml <dhtmlkitc...@g mail.comwrote:

Dr J R Stockton wrote:

| Replying
|
| * Quote the minimum of the preceding messages that is
| sufficient to provide context for the reply but trim the remainder,
| and add your comments below the pertinent section of quoted
| material, as per FYI28/RFC1855http://www.ietf.org/rfc/rfc1855.txt
| (never top post).

That could be simplified without loss of meaning, maybe :

* Quote only relevant parts of earlier messages, and add your
comments below each quoted section
(FYI28/RFC1855http://www.ietf.org/rfc/rfc1855.txt). Do not top-post.

| * Cite any part of the FAQ that applies. Be specific and link
| to the relevant section.

While the FAQ is being upheaved, "Give the heading of the relevant
section" will be safer. Even if it changes, a human should find the
replacement.

What do you think?

You don't seem to be trimming sigs! Else OK. You will have mail.

--
(c) John Stockton, near London, UK. Posting with Google.
Mail: J.R.""""""""@ph ysics.org or (better) via Home Page at
Web: <URL:http://www.merlyn.demo n.co.uk/>
FAQish topics, acronyms, links, etc.; Date, Delphi, JavaScript, ....|

**dhtml** · Oct 6 '08, 05:05 PM

Re: FAQ Noise

Dr J R Stockton wrote:

On Oct 6, 12:10 am, dhtml <dhtmlkitc...@g mail.comwrote:

>Dr J R Stockton wrote:

>

While the FAQ is being upheaved, "Give the heading of the relevant
section" will be safer. Even if it changes, a human should find the
replacement.
>

It would be even better if the IDs were not numbered but more semantic, e.g.

<h2 id='#getWindowS ize'>How do I find the size of the window?</h2>

That would require changes to the scripts and the XML.

>What do you think?

>
You don't seem to be trimming sigs! Else OK. You will have mail.
>

OK.

Suggestions applied.

Garrett

--

**Henry** · Oct 6 '08, 05:15 PM

Re: FAQ Noise

On Oct 6, 5:59 pm, dhtml wrote:
<snip>

It would be even better if the IDs were not numbered but more
semantic, e.g.
>
<h2 id='#getWindowS ize'>How do I find the size of the window?</h2>

^??

That would require changes to the scripts and the XML.

Remember that the archives are full of references to the FAQ using
those existing fragment identifiers, which should not rendered broken
by changes.

**Thomas 'PointedEars' Lahn** · Oct 6 '08, 05:25 PM

Re: FAQ Noise

dhtml wrote:

Dr J R Stockton wrote:

>On Oct 6, 12:10 am, dhtml <dhtmlkitc...@g mail.comwrote:

>>Dr J R Stockton wrote:

>While the FAQ is being upheaved, "Give the heading of the relevant
>section" will be safer. Even if it changes, a human should find the
>replacement.

>
It would be even better if the IDs were not numbered but more semantic, e.g.

Yes, indeed. Those two listing schemes can be combined, though.

<h2 id='#getWindowS ize'>How do I find the size of the window?</h2>

^^^^^^^^^^^^^^
That is obviously an invalid ID, and it is not backwards-compatible. Use
instead

<h2><a name="getWindow Size" id="getWindowSi ze"

>How do I find the size of the window?</a></h2>

(Shouldn't you know the basics before you attempt to improve something?
One really wonders how you of all applicants could get this job.)

PointedEars
--
var bugRiddenCrashP ronePieceOfJunk = (
navigator.userA gent.indexOf('M SIE 5') != -1
&& navigator.userA gent.indexOf('M ac') != -1
) // Plone, register_functi on.js:16

**Dr J R Stockton** · Oct 6 '08, 09:15 PM

Re: FAQ Noise

On Oct 6, 6:13 pm, Henry <rcornf...@rain drop.co.ukwrote :

On Oct 6, 5:59 pm, dhtml wrote:
<snip>
>

It would be even better if the IDs were not numbered but more
semantic, e.g.

>

<h2 id='#getWindowS ize'>How do I find the size of the window?</h2>

^??

That would require changes to the scripts and the XML.

>
Remember that the archives are full of references to the FAQ using
those existing fragment identifiers, which should not rendered broken
by changes.

I think that it might be better if the previous FAQ, version 9.91 of
2008-01-19, were restored to its previous URL, making the current
document-in-hand formally a different document, perhaps in a clj-faq
directory rather than the faq directory. That would automatically
repair the old references.

The revised work could be headed
"New FAQ for comp.lang.javas cript - 10.00* - 2008-10-??"
We've had a New Forest in Southern England since 1086 or earlier, so
there need ne no hurry to remove the adjective.

--
(c) John Stockton, near London, UK. Posting with Google.
Mail: J.R.""""""""@ph ysics.org or (better) via Home Page at
Web: <URL:http://www.merlyn.demo n.co.uk/>
FAQish topics, acronyms, links, etc.; Date, Delphi, JavaScript, ....|

**dhtml** · Oct 6 '08, 09:25 PM

Re: FAQ Noise

Dr J R Stockton wrote:

On Oct 6, 6:13 pm, Henry <rcornf...@rain drop.co.ukwrote :

>On Oct 6, 5:59 pm, dhtml wrote:
><snip>
>>

The revised work could be headed
"New FAQ for comp.lang.javas cript - 10.00* - 2008-10-??"
We've had a New Forest in Southern England since 1086 or earlier, so
there need ne no hurry to remove the adjective.
>

That's not a bad idea. It's bit of work, though.

I should be starting a contract very soon.

I think in the meantime, I can still make amendments to the current FAQ.

Garrett

--

**dhtml** · Oct 6 '08, 09:25 PM

Re: FAQ Noise

dhtml wrote:

Dr J R Stockton wrote:

>On Oct 6, 6:13 pm, Henry <rcornf...@rain drop.co.ukwrote :

>>On Oct 6, 5:59 pm, dhtml wrote:
>><snip>
>>>

>
>

>The revised work could be headed
> "New FAQ for comp.lang.javas cript - 10.00* - 2008-10-??"
>We've had a New Forest in Southern England since 1086 or earlier, so
>there need ne no hurry to remove the adjective.
>>

>
That's not a bad idea. It's bit of work, though.
>
I should be starting a contract very soon.
>
I think in the meantime, I can still make amendments to the current FAQ.
>

And that way, if the archives are searched, and the FAQ is linked, then
new, updated information would be returned.

Garrett
>

>--

FAQ Noise

FAQ Noise

Comment

Comment

Comment

Comment

Comment

Comment

Comment

Comment

Comment

Comment

Comment

Comment

Comment

Comment