New FAQ Version for review

**Richard Cornford** · Nov 26 '06, 11:35 PM

Re: New FAQ Version for review

Randy Webb wrote:

There is an updated version of the FAQ at:
<URL: http://jibbering.com/faq/newfaq/>
>
The changes/modifications to date are:

<snip>

4.9 Retitled "How do I find the size of the browser canvas area?"

I take it you did not buy Lee's justification that the question that
actually is frequently asked is about "window" size, even if the
information required, and the answers given, actually relate to client
area size?

4.13 Slightly reworded.

<snip>

I never thought that there was anything wrong with the wording of 4.13
as it was, but while you are enumerating situations where just reading -
contrl.value - is problematic don't <IINPUT type="file"elem ents
qualify?

Richard.

**Randy Webb** · Nov 27 '06, 04:45 AM

Re: New FAQ Version for review

Richard Cornford said the following on 11/26/2006 6:51 PM:

Randy Webb wrote:

>There is an updated version of the FAQ at:
><URL: http://jibbering.com/faq/newfaq/>
>>
>The changes/modifications to date are:

<snip>

>4.9 Retitled "How do I find the size of the browser canvas area?"

>
I take it you did not buy Lee's justification that the question that
actually is frequently asked is about "window" size, even if the
information required, and the answers given, actually relate to client
area size?

I can buy that justification, it is just a misleading title is all. It
is now reworded again:

"How do I find the size of the window/browser canvas area?"

With this note:

While it is often asked about window size, what is more relevant is the
"canvas area" of the browser.

>4.13 Slightly reworded.

<snip>
>
I never thought that there was anything wrong with the wording of 4.13
as it was,

The wording, as it was, implied there was One exception, then it says
there is another exception. It was just misleading to me is all and if
it gets to where the way it is now is misleading, it can be changed back.

but while you are enumerating situations where just reading -
contrl.value - is problematic don't <IINPUT type="file"elem ents
qualify?

Sure it does, and there is now a small snippet there. I was going to
find a section of <URL:
http://www.jibbering.c om/faq/faq_notes/form_access.htm lthat dealt with
File Inputs but it doesn't appear anywhere in that document.

I am pretty sure the wording of Third Exception leaves a lot to be
desired and is open to be changed again.

--
Randy
Chance Favors The Prepared Mind
comp.lang.javas cript FAQ - http://jibbering.com/faq
Javascript Best Practices - http://www.JavascriptToolbox.com/bestpractices/

**RobG** · Nov 27 '06, 04:55 AM

Re: New FAQ Version for review

Randy Webb wrote:

There is an updated version of the FAQ at:
<URL: http://jibbering.com/faq/newfaq/>

[...]

Thoughts and comments are welcome.

Can you update the CSS? The current FAQ looks very, very dated. The
format of the "Javascript Best Practices" page is pretty good[1],
perhaps that (or something similar) can be adopted without too much
effort?

Maybe Matt would volunteer, if not, I'm happy to do it.

1. The text is set too small and the dashed borders are kitsch ;-),
otherwise it's simple, clean and reasonably modern.

--
Rob

**Randy Webb** · Nov 27 '06, 05:15 AM

Re: New FAQ Version for review

RobG said the following on 11/27/2006 12:20 AM:

Randy Webb wrote:

>There is an updated version of the FAQ at:
><URL: http://jibbering.com/faq/newfaq/>

[...]

>Thoughts and comments are welcome.

>
Can you update the CSS?

Sure can, its a work in progress :)

The current FAQ looks very, very dated. The format of the "Javascript
Best Practices" page is pretty good[1], perhaps that (or something
similar) can be adopted without too much effort?

It would just be a matter of creating a file call faq.css and uploading it.

Maybe Matt would volunteer, if not, I'm happy to do it.

Save the index.html and faq.css files locally, modify them and email
them to cljfaq@ctvea.ne t and I can upload it and get it reviewed.
<URL: http://jibbering.com/faq/newfaq/index.html>
<URL: http://jibbering.com/faq/newfaq/faq.css>

--
Randy
Chance Favors The Prepared Mind
comp.lang.javas cript FAQ - http://jibbering.com/faq
Javascript Best Practices - http://www.JavascriptToolbox.com/bestpractices/

**Randy Webb** · Nov 27 '06, 08:55 AM

Re: New FAQ Version for review

Randy Webb said the following on 11/26/2006 5:39 PM:

There is an updated version of the FAQ at:
<URL: http://jibbering.com/faq/newfaq/>

There is a new upload there that reflects some changes based on Richards
thoughts, Evertjan's comma and a section 4.44 entitle "What is AJAX?"

Any thoughts, comments or corrections appreciated.

--
Randy
Chance Favors The Prepared Mind
comp.lang.javas cript FAQ - http://jibbering.com/faq
Javascript Best Practices - http://www.JavascriptToolbox.com/bestpractices/

**Bart Van der Donck** · Nov 27 '06, 10:25 AM

Re: New FAQ Version for review

Randy Webb wrote:

Randy Webb said the following on 11/26/2006 5:39 PM:

There is an updated version of the FAQ at:
<URL: http://jibbering.com/faq/newfaq/>

>
There is a new upload there that reflects some changes based on Richards
thoughts, Evertjan's comma and a section 4.44 entitle "What is AJAX?"
>
Any thoughts, comments or corrections appreciated.

Thanks for the good work !

--
Bart

**Richard Cornford** · Nov 27 '06, 11:25 PM

Re: New FAQ Version for review

Randy Webb wrote:

Richard Cornford said the following on 11/26/2006 6:51 PM:

>Randy Webb wrote:

<snip>

>I never thought that there was anything wrong with the
>wording of 4.13 as it was,

>
The wording, as it was, implied there was One exception,
then it says there is another exception.

<snip>

No it did not. It gave two examples of exceptions form an indefinite
set.

Richard.

**Randy Webb** · Nov 27 '06, 11:55 PM

Re: New FAQ Version for review

Richard Cornford said the following on 11/27/2006 6:36 PM:

Randy Webb wrote:

>Richard Cornford said the following on 11/26/2006 6:51 PM:

>>Randy Webb wrote:

<snip>

>>I never thought that there was anything wrong with the
>>wording of 4.13 as it was,

>The wording, as it was, implied there was One exception,
>then it says there is another exception.

<snip>
>
No it did not.

Yes it did.

It gave two examples of exceptions form an indefinite set.

The set of form elements and the ways of accessing them is not an
indefinite set, nor are the problems associated with it. So a subset of
a fixed set can't be an indefinite set.
--
Randy
Chance Favors The Prepared Mind
comp.lang.javas cript FAQ - http://jibbering.com/faq
Javascript Best Practices - http://www.JavascriptToolbox.com/bestpractices/

**Martin Honnen** · Nov 28 '06, 05:05 PM

Re: New FAQ Version for review

Randy Webb wrote:

Randy Webb said the following on 11/26/2006 5:39 PM:

>There is an updated version of the FAQ at:
><URL: http://jibbering.com/faq/newfaq/>

>
There is a new upload there that reflects some changes based on Richards
thoughts, Evertjan's comma and a section 4.44 entitle "What is AJAX?"

Nit on spelling in the AJAX explanation, the object is named
"XMLHttpRequest " and not "XMLHTTPRequest ".

You could also add links to the Mozilla documentation
<http://developer.mozil la.org/en/docs/XMLHttpRequest>
and the IE documentation of the object
<http://msdn.microsoft. com/library/default.asp?url =/workshop/author/dhtml/reference/objects/obj_xmlhttprequ est.asp>
<http://msdn.microsoft. com/library/default.asp?url =/library/en-us/xmlsdk/html/63409298-0516-437d-b5af-68368157eae3.as p>

--

Martin Honnen

Attention Required! | Cloudflare

http://JavaScript.FAQTs.com/

**Randy Webb** · Nov 28 '06, 05:45 PM

Re: New FAQ Version for review

Martin Honnen said the following on 11/28/2006 12:21 PM:

Randy Webb wrote:

>Randy Webb said the following on 11/26/2006 5:39 PM:

>>There is an updated version of the FAQ at:
>><URL: http://jibbering.com/faq/newfaq/>

>>
>There is a new upload there that reflects some changes based on
>Richards thoughts, Evertjan's comma and a section 4.44 entitle "What
>is AJAX?"

>
Nit on spelling in the AJAX explanation, the object is named
"XMLHttpRequest " and not "XMLHTTPRequest ".
>
You could also add links to the Mozilla documentation
<http://developer.mozil la.org/en/docs/XMLHttpRequest>
and the IE documentation of the object
<http://msdn.microsoft. com/library/default.asp?url =/workshop/author/dhtml/reference/objects/obj_xmlhttprequ est.asp>
>
<http://msdn.microsoft. com/library/default.asp?url =/library/en-us/xmlsdk/html/63409298-0516-437d-b5af-68368157eae3.as p>

Is it worth using the non-framed URL for the MSDN articles? It makes it
even longer for the FAQ:

<URL:
http://msdn.microsoft. com/library/default.asp?url =/workshop/author/dhtml/reference/objects/obj_xmlhttprequ est.asp?frame=t rue&hidetoc=tru e>

I tried this one:

<URL:
http://msdn.microsoft. com/workshop/author/dhtml/reference/objects/obj_xmlhttprequ est.asp>

And it takes you to the page but then MS automatically puts it back in
the frameset with the tree view :\

--
Randy
Chance Favors The Prepared Mind
comp.lang.javas cript FAQ - http://jibbering.com/faq
Javascript Best Practices - http://www.JavascriptToolbox.com/bestpractices/

**Martin Honnen** · Nov 28 '06, 06:05 PM

Re: New FAQ Version for review

Randy Webb wrote:

Is it worth using the non-framed URL for the MSDN articles?

Hard to answer in general, I prefer having the toc tree on the left to
be able to navigate easily to e.g. objects/properties/methods. But I am
usually sitting in front of a desktop system with a large enough monitor
not to be hurt by frames taking up space. A laptop user might have other
preferences.

--

Martin Honnen

Attention Required! | Cloudflare

http://JavaScript.FAQTs.com/

**Dr J R Stockton** · Nov 28 '06, 06:05 PM

Re: New FAQ Version for review

In comp.lang.javas cript message <37qdnY_T3dfNiv fY4p2dnA@telcov e.net>,
Sun, 26 Nov 2006 17:39:09, Randy Webb <HikksNotAtHome @aol.comwrote:

>There is an updated version of the FAQ at:
><URL: http://jibbering.com/faq/newfaq/>

It (unlike 8.1) lacks a clear statement as to who maintains it.

Also, it's not clear what the present status of the FAQ Notes is.
Are they still maintained?
Are they abandonware, (c) RC?
Are they detached parts of the FAQ, similarly maintained, (c)
newsgroup?

IMHO, each Note should be annotated with the name of its author, its
maintainer if different, and its date; the link to the index page should
be dejargonised and repeated at the top, and the Notes index page should
enlarge a little on such matters. The final link at the top of Notes
Index, to zipped Notes & FAQ, needs consideration.

<FAQENTRY>FAQ section 1, or thereabouts, should contain a link to each
individual Note, as a list.
</FAQENTRY>

If they are not now maintained, the FAQ should make that clear.

>4.20 Updated to refer to the delay in setTimeout and setInterval

The added sentence includes "generally" . ISTM that, for the common case
where the requested delay is a multiple of the tick interval, IE6 in
WinXP does not do that; and if IE6 (so, probably, IE7?) does not do it,
can "generally" be right?

The delay is not *caused* by the difference.

"The delay ... may exceed ... (browsers differ)."

TIDY checker reports missing <liin 4.29. Probably four are missing
(see issue 8.1, 4.29).

2.1 : Subject now ungrammatical.

4.12 Subject : but parseInt('09') does not give an error. It gives, as
it should, a Number of value 0.

"4.12 Why does K = parseInt('09') set K to 0?

Function parseInt(S, B) accepts two arguments, string S and base B; the
first character (leading whitespace excepted) in S which in that
position cannot be part of a base-B number terminates number reading.

If B is not given : S with leading "0x" or "0X" is read as Hexadecimal,
else S with leading "0" is read as Octal, otherwise S is read as
Decimal. Generally, it is better to use unary + : K = +S ."

N.B. When an entry's Subject is a question, the entry's body should
*always* explicitly answer that question. It should usually, but should
not only, present a solution to any implied problem. If necessary,
change the Subject.

4.16 How do I trim whitespace ...

String "aaa zzz" contains trimmable whitespace; but the entry ignores
that case. ASCII should read Unicode.

Count : "enviroment " 3, "environmen t" 1.

>I think that 3.2 is getting sufficiently lengthy enough that it might
>benefit from being moved to a page of it's own.

Can one have confidence in an author who, seemingly having lived for
many years in a nominally English-speaking country, and in spite of
frequently-presented examples in this newsgroup, still apparently
believes "it's" to be a genitive? Also FAQ 4.44.

It's a good idea to read the newsgroup and its old FAQ. See below.

--
(c) John Stockton, Surrey, UK. ?@merlyn.demon. co.uk Turnpike v6.05 IE 6
<URL:http://www.jibbering.c om/faq/ Old RC FAQ of news:comp.lang. javascript
<URL:http://www.merlyn.demo n.co.uk/js-index.htmjscr maths, dates, sources.
<URL:http://www.merlyn.demo n.co.uk/TP/BP/Delphi/jscr/&c, FAQ items, links.

**RobG** · Nov 28 '06, 11:35 PM

Re: New FAQ Version for review

Randy Webb wrote:

RobG said the following on 11/27/2006 12:20 AM:

Randy Webb wrote:

There is an updated version of the FAQ at:
<URL: http://jibbering.com/faq/newfaq/>

[...]

Thoughts and comments are welcome.

Can you update the CSS?

[...]

>
Save the index.html and faq.css files locally, modify them and email
them to clj...net and I can upload it and get it reviewed.

OK, done that.

Mac users (Safari users in particular) should change their monospace
font to Monaco 14pt, the default Courier (new) 13pt is way too small on
all browsers and monitors.

--
Rob

**Peter Michaux** · Nov 29 '06, 01:05 AM

Re: New FAQ Version for review

Randy Webb wrote:

There is an updated version of the FAQ at:
<URL: http://jibbering.com/faq/newfaq/>

<snip>

Thoughts and comments are welcome.

Below are a few.

Peter

------------

There seem to be two leading spaces at the start of each code example.

------------

In section 4.9

When using IE6 with in CSS1Compat mode (with a Formal DOCTYPE)

Would this be clearer as the following?

When using IE6 with in CSS1Compat mode (i.e. with a Formal DOCTYPE)

------------

In section 4.13

In HTML documents, named forms may be referred to as named properties of the document.forms collection

It seems to me that named forms are also available as properties of the
document object.

------------

In section 4.15

Using the DOM and Microsoft's innerHTML extension

This could be interpreted as innerHTML is only available in IE. Could
"Microsoft' s" be replaced with "the non-standard but widely
implemented"

The code example in this section seems to be for browsers without
function literals. To which browsers does this cater? Does this example
deserve updating?

------------

In Section 4.18

The last sentance in section 4.18 could be moved to 4.44

------------

In Section 4.22

The function name "Random" is capitalized which is usually reserved for
constructor functions. Perhaps this should be lower case

The featured code in the yellow box doesn't answer the section's title
question. The actual answer is added like an after thought.

gives a random number in the range 0..(x-1); Random(N)+1 for [1..N]

The range notation is not consistent in this sentence. I suggest the
use standard range notation: [1, N] and [1, N) or [1, N-1]

------------

Could sections 4.25 and 4.39 should be close together or merged?

------------

In Section 4.31

Could a mention of preloading images be added. Something like

(new Image()).src = "http://example.com/maui.gif"

If the image is served with correct headers when this JavaScript runs
then the first time the roll over is used it won't be slow, at least in
some browsers.

Perhaps mentioning that sliding images can be used instead like RobG (I
believe) mentioned within the last weeks.

------------

In Section 4.34

Mozilla, Safari, and the Windows version of IE (and Opera 7.6+)

I think Opera deserves to be outside of parentheses. Something like
this with the correct version numbers. (I'll research the correct
numbers if someone doesnt know off the top of their more knowing head.)
Something more like this...

Mozilla (NN6+, Firefox, Ice Weasle etc), Opera 7.6+, Safari, the
Windows version of IE versions 5+, and some other browsers

------------

In Section 4.39

There are two equivalent ways to access properties

I suggest the removal of the word equivalent

------------

In Section 4.43

The Firebug extension in Firefox is so valuable I think it is worth a
mention. Firebug is just going to version 1.0

Firebug

http://www.getfirebug.com/

------------

In Section 4.44

Ajax only has one capital letter. It may be an acronym but Ajax was
also a Greek God or something.

http://www.adaptivepath.com/publications/essays/archives/000385.php

New FAQ Version for review

New FAQ Version for review

Comment

Comment

Comment

Comment

Comment

Comment

Comment

Comment

Comment

Comment

Comment

Comment

Comment

Comment