Talk:Spacetime/Archive 15

From Wikipedia, the free encyclopedia

Archive 10Archive 13Archive 14Archive 15Archive 16Archive 17Archive 20

Expressing math notation, units of measure, buzzwords, and linking

Overview
Wikipedia’s Manual of Style: Dates and Numbers (WP:MOSNUM) has some wonderful guidance on expressing units of measure. I was tempted to transplant a small bit of cherry-picked examples from its guidance here, but realized it is so well written and succinct, it’s best just to provide the link. So…

The following are my thoughts on how WP:MOSNUM’s principles apply to some specifics of our Spacetime article.


Avoid “sciencey” math notation
Notwithstanding that experts in a field will understand what 1.2 m·s−2 means, instead writing 1.2 meters/second2 makes the measure fully accessible to a larger segment of our visiting readership. Wikipedia is a general-interest encyclopedia; Ph.D.s don’t come to Wikipedia to learn something within their field of expertise. When doing technical writing, one must always consider the gamut of the target audience and try to make the article accessible to the lowest level of that gamut.


Where practical, spell out unit names unless the unit symbol is ubiquitous in everyday life
Take this example of of two unit symbols (km and s):

nearly 300,000 km in space being equivalent to 1 s in time
instead becomes…
nearly 300,000 km in space being equivalent to 1 second in time.


Note how “s” became “second” but “km” remained as a unit symbol. Why? Except for in America, both “km” and “km/hr” are seen so often in real life, they become spelled-out units of measure in its own right even though they are technically unit symbols. We also take into consideration the assumed expertise of the readership of the article; writing for our Dog article is different from our Year article, which is different from our Spacetime article. As for Americans and their Customary units of measure in normal life, we can safely assume Americans visiting this particular article are familiar with “km” and “km/hr”. However, “km/s” is not on traffic signs. This principle of spelling out units of measure should generally be adhered to unless doing so makes a paragraph or article section tedious and cumbersome for our readership. On that subject…


Properly introduce “sciencey” unit symbols before using them
If a cumbersome (lengthy and multi-syllabic) scientific unit of measure (one not frequently encountered in real life) repeatedly appears in the same article section and is getting tedious to read, then writers should parenthetically introduce the unit symbol before employing it. Thus, the first occurrence in the section that looks like this:

30 MeV
instead becomes…
30 million electron volts (MeV)

After a proper parenthetical introduction, authors may then use the unit symbol (30 MeV) throughout the rest of the passage. The point of using unit symbols where they are frequently encountered isn’t to save ourselves time when writing, but to save our readers mental energy and make the text faster to read.

Authors should also consider allowing greater repetition of a spelled-out unit of measure (avoiding unit symbols) if it is short or monosyllabic, like meter, volt, watt, hertz, lux, year, hour, and joule. A paragraph containing three or four instances similar to the following…

A total surge energy of 30 joules caused the expected damage.
is more natural to read than…
A total surge energy of 30 J caused the expected damage.

…without undue tediousness.


Avoid Click To Learn & Return©™®. Don’t require readers to click links to understand the material at hand
It is good to avoid the overused Wikipedia practice of “We have links, so let’s embrace Click To Learn & Return©™®.” If a noun, term, or phrase is specialty lingo within an art, we shouldn’t use it in an “Oh… didn’t-cha know?”-fashion and expect the mere presence of a link to be sufficiently informative without the courtesy of also providing a simple explanatory parenthetical. Take, for instance, our article on the Space Needle; verbiage like this:

An imitation carillon was installed in the Space Needle.
instead becomes…
An imitation carillon (a multi-bell musical device) was installed in the Space Needle.

Avoiding Click to Learn & Return by adhering to conventional technical writing practices makes the learning experience faster and more enjoyable for our visiting readership because they don’t have to click a link, wade half-way through the other article's lede, and return to the article they were reading. The article the reader is currently reading should adequately explain new and unfamiliar terminology so the reader can fluidly comprehend and learn without interruption. We provide links only as a convenience to the reader to inform them that a separate article exists should they desire to later explore that topic for in-depth knowledge.


As an alternative to parentheticals, Click to Learn & Return can be avoided fluidly and naturally by explaining the concept first and then adding a clause to introduce the specialty lingo, like the following example with the term “manifold”:

By combining space and time into a single manifold called Minkowski space in 1908, physicists significantly simplified a
instead becomes…
[Minkowski] fused time and the three spatial dimensions of space into a single four-dimensional continuum now known as Minkowski space, what mathematicians refer to as a type of 4‑dimensional manifold.

Italicizing to set off lingo-speak is an option to employ depending upon nuances such as whether it is a compound noun or the lingo-speak is especially obscure.

In all cases when doing technical writing, one carefully considers the sophistication level of the target readership. Clearly, if the vast majority of the target readership can be expected to be familiar with buzzwords common to an art, we wouldn’t speak down to the audience by pulling out the Ernie & Bert puppets to explain the obvious. For instance, an article on a particular kind of musical instrument requires no explanatory verbiage for terms like frequency or musical note; the link alone is sufficient.


Over-linking (on Wikipedia, I link, therefore I am)
Avoid over-linking (here is amusing example). Links within Wikipedia articles should always be topical and germane. Properly chosen links anticipate what the readership of any given article would likely be interested in further reading. Here at Spacetime, we wouldn’t link “light”, “motion”, or “year” just because we can. I think this article is in fine shape in this regard.

Greg L (talk) 18:27, 23 June 2017 (UTC)

Protest

I want to express my strong objection, firstly to placing the above essay-like variations on the theme of WP:MOS on the talk page of the article entitled Spacetime, because it has no relation to its specific content, and secondly to the content of this comment, trying to prescribe a style, partly inappropriate for an encyclopedia, and not being fully covered by the established policies of WP. Purgy (talk) 13:10, 26 June 2017 (UTC)

What part of “The following are my thoughts”… did you find confusing, Purgy? Methinks thou dost protest too much. If you have a good idea on how we can improve the article, ample digital whitespace is available for constructive help, such as writing your own WP:Essay; they exist for a reason. Greg L (talk) 20:50, 27 June 2017 (UTC)
The problem is not me, in finding things confusing, but you, in repeatedly(!) violating established WP policies, e.g. in editing my intended and coherent layout. I will not elaborate on your efforts to commandeer this whole article, including this talk page, even when being rather clueless on any stringent background of the topic. I cite: "We don’t need any of that here." Meanwhile, others try to discuss the matter. Roma locuta? Purgy (talk) 06:15, 28 June 2017 (UTC)
I see. As regards my above WP:essay on how to keep things as easy as possible to read on an already exceedingly technical article, you are just wrong; an essay on such a topic is perfectly OK. I suggest you read the link I provided.
As regards me and others “violating established WP policies”, where I edited text of yours you felt was “intended” and “coherent”, try not to take the collaborative writing process so personally; it is inherent to the Wikipedia experience for others to discuss and change something you wrote. With specific regard to that edit you seem to be chaffing about, User:Stigmatella aurantiaca responded to you personally as follows (∆ edit here):
You've made some good suggestions in the past, but English does not appear to be your native language. So I've taken your suggested changes here where you and User:Greg L can work on them together. Hope you don't mind too much?.
On a final note, you made a comment here, (∆ edit) where you wrote…
I did not quit cooperation on it for the behaviour of one single disruptive IP-editor, but I explicitly declared four contributors as causing me troubles in cooperating.
Going forward, collaboration usually works better if you don’t bitterly and explicitly complain about the behavior of virtually the entire population of editors who are active on this article. Regards. Greg L (talk) 19:01, 28 June 2017 (UTC)
Evidently, I lack the required professionalism to formulate text in a way that is sufficiently accessible to you in its fundamental details (layout vs content, placement vs existence of essays, talk pages vs articles, ... ). Therefore, I walk away from the carcass of this discussion like from beating a dead horse. Purgy (talk) 06:01, 29 June 2017 (UTC)

Draft of revised history section for discussion

Related Articles

Wikiwand AI