FAQ Topic - What is the Document Object Model (DOM)? (2009-11-26)

D

Dr J R Stockton

For the simple-=minded pedants : that applies to all of the acronyms in
the FAQ. There is at least one.

It does not of itself apply to non-acronyms; but it indicates an
argument which applies equally well to abbreviations and to jargon in
general.

The explanations need to be in ordinary displayed text; using some HTML
feature such as <abbr> which may or may not be displayed is permissible
but insufficient.

Moreover, since the FAQ is posted in parts to the newsgroup for comment,
the explanations need to be in a form which will naturally appear there
in a similar form.

Aside : Someone recently has remarked on the ugly and
distracting (to the literate) quote-marks which
appear in the news version, I think where the HTML
has <code> & </code>. It would be better to use
either underscore (which is not otherwise needed)
or a si8ngle space (making three in all).
 
T

Thomas 'PointedEars' Lahn

Dr said:
[abbreviations and jargon in the FAQ]
The explanations need to be in ordinary displayed text; using some HTML
feature such as <abbr> which may or may not be displayed is permissible
but insufficient.

Yes, an explaining `title' attribute, and a glossary link and entry would
be a good idea.
Moreover, since the FAQ is posted in parts to the newsgroup for comment,
the explanations need to be in a form which will naturally appear there
in a similar form.

Aside : Someone recently has remarked on the ugly and
distracting (to the literate) quote-marks which
appear in the news version, I think where the HTML
has <code> & </code>.

That someone was me.
It would be better to use
either underscore (which is not otherwise needed)

The underscore is defined as a means to provide underlined formatting for
supporting user agents. If the source code would be displayed underlined,
it would be harder to read. Those user agents include Mozilla-based ones
(SeaMonkey, Thunderbird etc.), Outlook Express with plugin (perhaps Windows
Mail too?), KNode and presumably others, so that is not a good idea.
or a si8ngle space (making three in all).

A lot better.


PointedEars
 
D

Dr J R Stockton

In comp.lang.javascript message <[email protected]>,
Sun, 28 Feb 2010 01:10:40, Thomas 'PointedEars' Lahn
Dr said:
[abbreviations and jargon in the FAQ]
The explanations need to be in ordinary displayed text; using some HTML
feature such as <abbr> which may or may not be displayed is permissible
but insufficient.

Yes, an explaining `title' attribute, and a glossary link and entry would
be a good idea.

No, not "title". The literate expect to see such things in-line in the
displayed text, either as "Eritrean Judo Association (EJA)" or as "EJA
(Eritrean Judo Association)" on first appearance. One should not be
forced to look elsewhere for abbreviations / acronyms.

That should be done also for things which look like abbreviations
acronyms but [now] are not : e.g. ECMA (ex- European Computer
Manufacturers Association, now Ecma International) _ or just _ ECMA (now
Ecma International).
That someone was me.


The underscore is defined as a means to provide underlined formatting for
supporting user agents. If the source code would be displayed underlined,
it would be harder to read.

I did not write "underline". Underscore is a character, ASCII 95, which
can be put in News wherever it is wanted. I did not suggest that it be
put in the HTML, rather that it be added, in place of the characters `
and ` , by the HTML-to-text conversion process. Bart?

Underscore works better than a space when it falls at the end of a line.

You are not very good at reading English, presumably because of undue
haste. Festina lente.
 
T

Thomas 'PointedEars' Lahn

Dr said:
Thomas 'PointedEars' Lahn posted:
Dr said:
[abbreviations and jargon in the FAQ]
The explanations need to be in ordinary displayed text; using some HTML
feature such as <abbr> which may or may not be displayed is permissible
but insufficient.
Yes, an explaining `title' attribute, and a glossary link and entry
would be a good idea.

No, not "title".

Yes, `title'.
The literate expect to see such things in-line in the
displayed text, either as "Eritrean Judo Association (EJA)" or as "EJA
(Eritrean Judo Association)" on first appearance. One should not be
forced to look elsewhere for abbreviations / acronyms.

Your logic is flawed. One uses abbreviations in text in order _not_ to
disturb the flow of reading with complex explanations.

The `title' attribute of an (X)HTML element can and is specified to provide
immediate information as to the meaning of the element's content, both for
visual and non-visual readers: it can be used for tooltips, either
implicitly (many graphical browsers do that) or explicitly (as a CSS-
powered tooltip, scripted too where available); screenreaders would allow
reading the value of the `title' attribute to the user. Furthermore, the
glossary entry can provide more detailed information, and the link to the
glossary entry on the element provides immediate access to the former.
Combining those two approaches avoids using complicated terms in the
original text. This provides the most user-friendly presentation of
textual information and is most appropriate for the Web. There is even a
built-in cursor shape that signifies the affordance of such a link: `help'.
That should be done also for things which look like abbreviations
acronyms but [now] are not : e.g. ECMA (ex- European Computer
Manufacturers Association, now Ecma International) _ or just _ ECMA (now
Ecma International).

If the `title' attribute or a tooltip created using other means would not
suffice, the linked glossary entry would.
I did not write "underline".

Underlined text is the possible outcome of using corresponding underscore
characters.
Underscore is a character, ASCII 95, which can be put in News wherever it
is wanted.

Apparently you do not understand that certain characters are given special
meaning, not only semantically, but in actual text formatting, when used in
corresponding pairs: *bold* /italic/ _underline_ While some newsreaders
are more lenient not to consider those characters format delimiters when
they are set apart with whitespace, or followed or preceded by punctuation,
others are not.
I did not suggest that it be put in the HTML,

I was/am well aware of that.
rather that it be added, in place of the characters ` and ` , by the
HTML-to-text conversion process.

Yes, and I pointed out that and why that would be not a good idea. Another
important counter-argument is ambiguity: _ is a valid identifier.
Underscore works better than a space when it falls at the end of a line.

When source code would span several lines, or there would be other possible
ambiguities, it should be set apart differently (new paragraph,
indentation). Regardless, your argument is flawed as a trailing whitespace
character followed by underscore is likely to result in the underscore
character being word-wrapped to the next line, still leaving doubt as to
whether the underscore belonged to the source code or delimited it.
You are not very good at reading English, presumably because of undue
haste. Festina lente.

Pot, kettle, black.


PointedEars
 

Ask a Question

Want to reply to this thread or ask your own question?

You'll need to choose a username for the site, which only take a couple of moments. After that, you can post your question and our members will help you out.

Ask a Question

Members online

No members online now.

Forum statistics

Threads
473,969
Messages
2,570,161
Members
46,710
Latest member
bernietqt

Latest Threads

Top