FAQ Sections - Feedback Wanted

[dhtml]

Breaking up the FAQ has been discussed.

http://groups.google.com/group/comp....878ddfb2ac892/

I'm interested in doing this now. I propose something along the lines of:

* Numbers
* Windows and Frames
* Forms

I would like to hear feedback on this proposal.

Garrett

[Dr J R Stockton]

In comp.lang.javas cript message <gd**********@r egistered.motza rella.org>
, Mon, 13 Oct 2008 15:52:50, dhtml <dh**********@g mail.composted:

>Dr J R Stockton wrote:

>In comp.lang.javas cript message <gc**********@r egistered.motza rella.org>
, Sun, 12 Oct 2008 15:04:42, dhtml <dh**********@g mail.composted:

>>Dr J R Stockton wrote:

>>> Another category is those questions relating to ECMAScript/DOM
without
reference to anything visual or external :-
An 'Other' category?

I think that the idea of features related only to the manipulation
of
ordinary variables deserves a subsection,

Ah, but what is ordinary?

Approximately, those that one calls into existence with JavaScript
rather than those that are properties of the original document plus
added HTML things.

>What do you think of:

,--------------------------------------------------------------------
|
| • Meta-FAQ meta-questions
| * Which newsgroups deal with javascript?
| * What questions are on-topic for CLJ?
| * What should I do before posting to CLJ?
| * Why was my post not answered?
| * Why do some posts have <FAQENTRYin them?
| * How do I make a suggestion?
|
| • Javascript Tips

"Tips" seems wrong there. "About Scripting"??

>| o What is ECMAScript?
| o What is JScript?
| o What are object models?
| o What is the document object model?
| o Internationalis ation and Multinationalis ation in javascript.
| o Where are the CLJ archives located?

To previous section ?

>| o What does the future hold for ECMAScript?
|
| • Javascript Resources
| o What books cover javascript?
| o What online resources are available?
|
| • Dates
| o How do I format the lastModified date with javascript?
| • Numbers
| o How do I convert a Number into a String with exactly 2 decimal
| places?
| o Why does simple decimal arithmetic give strange results?
| o Why does K = parseInt('09') set K to 0?
| o Why does 1+1 equal 11? or How do I convert a string to a number?
| o How do I generate a random integer from 1 to N?
| • Objects
| o When should I use eval?
| o How do I access a property of an object using a string?
| • Strings and RegExps
| o How do I trim whitespace?
|
| • DOM and Forms
| o How do I get the value of a form control?
| o My element is named myselect[], how do I access it?
| o Why doesn't the global variable "divId" always refer to the
| element with id="divId"?
| o Why are my rollovers so slow?
| o How do I disable the right mouse button?
| o How do I detect Opera/Netscape/IE?
| o How do I modify the content of the current page?
| o How can I see in javascript if a web browser accepts cookies?
|
| • Windows and Frames
| o How do I communicate between frames in a web browser?
| o Why does framename.print () not print the correct frame in IE?
| o How do I change print settings with window.print()?

for

>| o I have window.status=" Moomin"; why doesn't the statusbar
| change?
| o How can I disable the back button in a web browser?
| o How do I find the size of the window?
| o How do I change the text in the url/location bar?
| o How do I POST a form to a new window?
| o How do I change the confirm box to say yes/no or default to
| cancel?
| o Why do I get permission denied when accessing a frame/window?
| o How do I modify the content of the current page?
| o How do I prompt a "Save As" dialog for an accepted mime type?
| o How do I open a new window with javascript?
| o How do I check to see if a child window is open, before opening
| another?
| o How do I close a window and why does it not work on the first
| one?
| o How do I make a 10 second delay?
|
| • Ajax

I *think* we had some of these answers before Ajax was known.
Therefore, if so, the above heading should be more generic.

>| o What is Ajax?
| o Why is my Ajax page not updated properly when using an HTTP GET
| request in Internet Explorer?
| o How do I download a page to a variable?
| o How do I get a perl/asp/php variable into client-side
| javascript?
| o How do I log-out a user when they leave my site?
| o How do I run a server side script?
| o How do I force a reload from the server/prevent caching?
|
| • Debugging
| o How do I get my browser to report javascript errors?

o Debugging Tips [1]

>|
|
| • Things not to attempt in a browser
| o How can I prevent access to a web page by using javascript?

[2]

>| o How do I protect my javascript code?

[2]

>| o How can I access the client-side filesystem?
| o I have <a href="javascrip t:somefunction( )"what ... ?
|
|
`-------------------------------------------------------------------------/

Otherwise OK. With anchors having names, parts can be moved at any
time. (Keep the numbers, for brief short-term reference in CLJ.)

[1] (condensed) : Test in small increments. Test locally, before
uploading. Verify presumptions. View intermediate results. Test with
many values. Check extreme cases and end-points. N.B. Debuggers report
where the existence of an error is detected, which is not necessarily
where the mistake is.

[2] : I disagree from the usual answer. If a script can be executed in
an Internet Browser, some people can read it. But many cannot read it -
those who know only Right Click, View Source can be utterly defeated by
breaking that operation. Many who want to protect their code do so
because they want to deter their idle and obtuse classmates from copying
it; the protection needs to be literally fool-proof, but not wise-proof.

--
(c) John Stockton, Surrey, UK. ?@merlyn.demon. co.uk Turnpike v6.05 MIME.
Web <URL:http://www.merlyn.demo n.co.uk/- FAQish topics, acronyms, & links.
Proper <= 4-line sig. separator as above, a line exactly "-- " (SonOfRFC1036)
Do not Mail News to me. Before a reply, quote with ">" or "" (SonOfRFC1036)

[Dr J R Stockton]

In comp.lang.javas cript message <gd**********@r egistered.motza rella.org>
, Tue, 14 Oct 2008 22:07:10, dhtml <dh**********@g mail.composted:

>Dr J R Stockton wrote:

>In comp.lang.javas cript message <gd**********@r egistered.motza rella.org>
, Mon, 13 Oct 2008 15:52:50, dhtml <dh**********@g mail.composted:

>>What do you think of:

>>| • Javascript Tips

"Tips" seems wrong there. "About Scripting"??

How about "Language Overview" ?

Or just "Overview" to avoid quibbling as to whether all entries are
about languages.

> Otherwise OK. With anchors having names, parts can be moved at any
time. (Keep the numbers, for brief short-term reference in CLJ.)

The numbers are generated in a loop. If I keep them in the loop, the
user will end up in the wrong place on the page. I can move them out of
the loop and hard code them into the xml, like:

Keep the customary sequential numbering system. In the HTML tags, use
named anchors for machines. In the HTML and News text, use visible
numbers for people.

>If it is difficult to read with the underline, I can use CSS to change
the appearance (blue, bold, perhaps, with underline on :hover).

No; remove all link appearance manipulation from the CSS. Default is
easier for all.

>[1] (condensed) : Test in small increments. Test locally, before
uploading. Verify presumptions. View intermediate results. Test with
many values. Check extreme cases and end-points. N.B. Debuggers report
where the existence of an error is detected, which is not necessarily
where the mistake is.

I think more complete advice on unit testing would be a lot better.

Not in the FAQ, for reason of size.


Suggestion : in "3.2 What online resources are available?" add a new
sub-section "FAQ Notes", start it with the existing FAQ material about
the Notes (changing the last paragraph of Section 1 to "There are _FAQ
Notes_." linking to the new sub-section, and append a list of FAQ Note
Subjects each linking to its Note. Then simplify the migrated waffle.

--
(c) John Stockton, nr London, UK. ?@merlyn.demon. co.uk Turnpike v6.05.
Web <URL:http://www.merlyn.demo n.co.uk/- w. FAQish topics, links, acronyms
PAS EXE etc : <URL:http://www.merlyn.demo n.co.uk/programs/- see 00index.htm
Dates - miscdate.htm moredate.htm js-dates.htm pas-time.htm critdate.htm etc.

[Dr J R Stockton]

On Oct 16, 7:14*am, dhtml <dhtmlkitc...@g mail.comwrote:

Dr J R Stockton wrote:

In comp.lang.javas cript message <gd3tq0$qn...@r egistered.motza rella.org>
, Tue, 14 Oct 2008 22:07:10, dhtml <dhtmlkitc...@g mail.composted:

Dr J R Stockton wrote:

Keep the customary sequential numbering system. *In the HTML tags, use
named anchors for machines. *In the HTML and News text, use visible
numbers for people.

There's discussion in the archive of section 2.3. If FAQ has section 2.3
being totally different it is confusing.

The numbers are meaningless. How can they change without resulting in
total confusion?

For example:

User reads text about Same Origin Policy with link to:
/faq/index.html#FAQ4 _8

This loads the page at:
5.3 How do I communicate between frames in a web browser?

Does that seem strange?

We cannot be bound by the details of the old numbering of sections.
IIRC, I suggested, when it was first evident that you were going to
tackle FAQ rearrangenent, that the file at http://jibbering.com/faq/index.html
should be as it were when Randy abandoned it[*], with the group
having a new FAQ (atarting with your current best) at a new URL.[*] But add a luridly-boxed note about and link to the new FAQ.

I doubt whether many read the archives and then try to cross-refer to
the FAQ; if they must, they should use the Wayback Machine to refer to
an approximately contemporaneous FAQ.

What you described is good advice, but doesn't describe what unit
testing is or how to do it.

N.B. What I described wasn't expected to be omission-free.

That's because (at least) I don't know what you mean by "unit
testing"; and I expect that many of the intended FAQ audience will not
know either.

--
(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]

Dr J R Stockton wrote:

On Oct 16, 7:14 am, dhtml <dhtmlkitc...@g mail.comwrote:

>Dr J R Stockton wrote:

>>In comp.lang.javas cript message <gd3tq0$qn...@r egistered.motza rella.org>
, Tue, 14 Oct 2008 22:07:10, dhtml <dhtmlkitc...@g mail.composted:
Dr J R Stockton wrote:

>
We cannot be bound by the details of the old numbering of sections.

What benefit does numbering have?

It isn't as if section 1 must be read completely before beginning to
read section 2.
In such a document, "Numbers" has meaning. "4" does not.

IIRC, I suggested, when it was first evident that you were going to
tackle FAQ rearrangenent, that the file at http://jibbering.com/faq/index.html
should be as it were when Randy abandoned it[*], with the group

Yes, you did.

having a new FAQ (atarting with your current best) at a new URL.[*] But add a luridly-boxed note about and link to the new FAQ.

I doubt whether many read the archives and then try to cross-refer to
the FAQ; if they must, they should use the Wayback Machine to refer to
an approximately contemporaneous FAQ.

We still have the problem of changing. When a hypothetical future
section 5 gets split to two sections, we have to renumber. Doing this
creates confusion.

What benefit do numbers add?

>

>What you described is good advice, but doesn't describe what unit
testing is or how to do it.

N.B. What I described wasn't expected to be omission-free.

That's because (at least) I don't know what you mean by "unit
testing"; and I expect that many of the intended FAQ audience will not
know either.

Unit testing javascript is excellent topic for discussion here.

(runs out to work)...

Garrett

[sasuke]

On Oct 10, 10:47*pm, dhtml <dhtmlkitc...@g mail.comwrote:

Breaking up the FAQ has been discussed.

http://groups.google.com/group/comp....wse_frm/thread...

I'm interested in doing this now. I propose something along the lines of:

* Numbers
* Windows and Frames
* Forms

I would like to hear feedback on this proposal.

The FAQ presents little [no?] information about `encoding' related
issues which do get asked frequently here. Many of them are along the
lines of:
- escape / unescape functions don't work well for Non-ASCII character
- encodeURICompon ent to be used for encoding URI components rather
than encodeURI
- Setting the HTTP Request Header `Content-Type: x-www-
formurlencoded' when making asynchronous requests doesn't
automagically encode the data being submitted.

These are some of the points which have come across in this group in
the past few days related to encoding. It would be nice to have
someone come up with a short FAQ entry related to this topic.

/sasuke

[sasuke]

On Oct 18, 7:33*pm, sasuke <database...@gm ail.comwrote:

*- Setting the HTTP Request Header `Content-Type: x-www-
formurlencoded' when making asynchronous requests doesn't
automagically encode the data being submitted.

Apologies; that should have been:
Content-Type: application/x-www-form-urlencoded

/sasuke

[dhtml]

sasuke wrote:

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

>Breaking up the FAQ has been discussed.

http://groups.google.com/group/comp....wse_frm/thread...

I'm interested in doing this now. I propose something along the lines of:

* Numbers
* Windows and Frames
* Forms

I would like to hear feedback on this proposal.

The FAQ presents little [no?] information about `encoding' related
issues which do get asked frequently here. Many of them are along the
lines of:
- escape / unescape functions don't work well for Non-ASCII character
- encodeURICompon ent to be used for encoding URI components rather
than encodeURI
- Setting the HTTP Request Header `Content-Type: x-www-
formurlencoded' when making asynchronous requests doesn't
automagically encode the data being submitted.

These are some of the points which have come across in this group in
the past few days related to encoding. It would be nice to have
someone come up with a short FAQ entry related to this topic.

Yep. That could go in the proposed "Communicat ing with the Server" section.

I haven't gotten much diversity of feedback on the proposed sections yet.

Garrett

/sasuke

--
comp.lang.javas cript FAQ <URL: http://jibbering.com/faq/ >