Author Topic: Why writing style and grammar matters in posts  (Read 862 times)

0 Members and 1 Guest are viewing this topic.

Online Nominal AnimalTopic starter

  • Super Contributor
  • ***
  • Posts: 6227
  • Country: fi
    • My home page and email address
Why writing style and grammar matters in posts
« on: April 11, 2024, 06:32:22 pm »
This is a technical forum where people interact with each other.  Some members speak English natively, but many do not.  I would like to take a minute of your time to explain in detail why writing style and grammar matters, and why you should spend the effort to do the best you can.

I am personally not a native English speaker at all, my own native language being Finnish, so I too have problems with specific facets of English (gendered pronouns, homophones that are not homographs, social subtext); plus my biggest fault is being overly verbose.  I write walls of text.  Sorry.

  • Communication is give and take.

    For others to show you courtesy, you need to show courtesy to them first.  This means that posts that look like they were carefully constructed, are more likely to get carefully considered responses.  If they look like they were thrown out without any interest in followups, they will be ignored.
     
  • Standard structure and grammar helps those not reading/writing/speaking English as their native language understand.

    Many of the members participating here read and write a lot of technical English, so it can be surprising that colloquialisms throw them off.  For example, in spoken English "to" and "too" sound so similar that native speakers naturally read them similar; not so for non-native readers.  Similarly, in written English "then"/"than", "which"/"witch", etc. homophones are not homographs, and mistaking them can severely confuse non-native readers, because to them, you're mixing completely unrelated words.  Thus, not caring about your writing style and grammar implies you do not care about non-native English speakers or their responses.
     
  • We discuss technical things here, so precision and clarity is highly appreciated.

    Nobody likes doing someone elses work for them, or trying to pull the necessary details needed to help with the problem from a vapid asker who does not have the time to help themselves, much less reciprocate.  Precision and clarity is the first step in reciprocating, showing that the asker spent enough effort in asking the question to make it worth answering, plus it makes it much easier for those interested in helping –– both native and non-native English speakers –– to help.
This does not mean that as readers, we should consider the lack of concise, clear style and perfect grammar an indication of anything.  Again, non-native English speakers make odd errors, and many technical people have dyslexia and other issues.  Fortunately, we don't need perfect communication to communicate efficiently and in mutually beneficial ways; we only need to do our best.

That means that it is okay to use online translators and large language models (GPT and similar) to help construct your posts.  You should ensure the translation or output matches your intent, though.  And, because of spammers exploiting them to present themselves as actual users, it is recommended you do not simply copy-paste the machine output into your post, but for example replace the least technical parts with your own words, even if poor English.  That way, you show you're spending the effort to interact with others.  If you make a typo or grammar error, you can edit your post and fix it.  If the misunderstanding is larger, acknowledge it and move on.

This forum is indexed by web search engines, and many readers come here because they found posts using terms related to some problem they are trying to solve.  Thus, it is not just your own immediate needs, but also future-you's needs, that admitting an error, and summarizing the solution you decided to go with in a post serves.  If we all do so, we don't need to re-ask questions already discussed, and can simply search for the relevant threads, read them, and learn everything we need.  Without admissions of error/misunderstanding and follow-up posts describing whether the solution worked, we all lose; so even if socially a bit awkward, in a technical discussion they are worth their gold.

Opinions are not interesting, because they cannot really be compared against each other, and they tend to change anyway as time progresses.  However, the reasoning and experience behind the opinions can be evaluated and adapted, so they are quite valuable.  Thus, instead of just posting your current opinion, it is better to describe why you have the opinion currently.  Also, while it is difficult to accept two opposing opinions at the same time, it is easy and natural to consider one acceptable in some specific situation, and the opposite in a different situation.

Because terms and abbreviations vary across the world, it is important to define the terms and abbreviations you use, to ensure your post is understood the way you intended.  For example, CIA does not always refer to an intelligence agency.  It may refer to a MOS 6526 or MOS 8520 Complex Interface Adapter IC (as used with the 6502 microprocessor), "Confidentiality, Integrity, Availability" (concept triplet in information security), CAN in automation, or a number of other things including four different international airports.  It also means that arguments like what a term exactly means (its definition) are useless, because it is just a matter of convention, and we can agree to one definition in one thread, and a different one in another thread; the important thing is that we all understand the posts the same way.

All of the above could be summarized as simply "because the important thing here is that the content of the post is understood the way the poster intended, and we are not telepaths".  Our interactions with each other are limited by the way we communicate.  By striving for minimal error rate, we strive for most mutually beneficial interactions, and maximal long-term gain for everyone.  We can tolerate error from those whose results are limited, but an increasing number of those who could but do not feel they need to spend the effort, can easily bring down the quality to where it is no longer mutually beneficial to interact.  Consider littering: it is much more difficult to be the first who litters at a clean place, than add to existing litter.  Small gestures matter.

Finally, because this is a forum with written text only, it is important to remember that others do not react to your person, they only react to your output.  And, we can affect our output without any change in our person.  Thus, by controlling your output, you can control how others react to you.  While this comes back to point 1. above, it also means that you should not take things personally: nobody knows you, they can only read what you have written.  So, if others' reaction to your output feels wrong or annoys you, consider whether there is some small change in your output that could change that.  It is easy but unrealistic to demand everyone else change; but even a small change in ones output can drastically change how others react to your posts.

Once again, I apologize for the wall of text.  The more important and/or many-sided I think the issue is, the more verbose I get.  It is a fault of mine I'm working on.  (My secret hope is that this will spur on a discussion as to what are the important key points, and that eventually someone summarizes them in a two-paragraph sticky post, useful for everyone.  But don't tell anyone yet; we'll have to just see if that happens.)
 
The following users thanked this post: EEVblog, T3sl4co1l, tooki, DimitriP, AndersJ, abeyer, Roehrenonkel, xvr

Offline tggzzz

  • Super Contributor
  • ***
  • Posts: 19447
  • Country: gb
  • Numbers, not adjectives
    • Having fun doing more, with less
Re: Why writing style and grammar matters in posts
« Reply #1 on: April 11, 2024, 06:57:09 pm »
Those three numbered points should definitely be read and understood and actioned by a small number of the posters on this forum. (No names, no witch hunt)

I try to follow Postel's Robustness Principle/Law: "be conservative in what you send, be liberal in what you accept" https://en.wikipedia.org/wiki/Robustness_principle

If I am asking other people to help me, it would be extremely rude (and self-defeating!) if I couldn't be bothered to help them to help me.  That's the first half of Postel's Law.
« Last Edit: April 11, 2024, 07:35:02 pm by tggzzz »
There are lies, damned lies, statistics - and ADC/DAC specs.
Glider pilot's aphorism: "there is no substitute for span". Retort: "There is a substitute: skill+imagination. But you can buy span".
Having fun doing more, with less
 

Offline IanB

  • Super Contributor
  • ***
  • Posts: 11849
  • Country: us
Re: Why writing style and grammar matters in posts
« Reply #2 on: April 11, 2024, 07:08:39 pm »
Supposing someone struggles to compose well structured and grammatically correct sentences (in any language), does that mean they might also struggle to compose well structured and electrically correct circuits, or might struggle to see where existing circuits might have problems? (Or for that matter, have similar difficulties with code and software?)

In all cases, logic, order and perception matter.
« Last Edit: April 11, 2024, 08:28:34 pm by IanB »
 
The following users thanked this post: bdunham7, xvr

Online Mechatrommer

  • Super Contributor
  • ***
  • Posts: 11612
  • Country: my
  • reassessing directives...
Re: Why writing style and grammar matters in posts
« Reply #3 on: April 11, 2024, 08:11:17 pm »
Supposing someone struggles to compose well structured and grammatically correct sentences (in any language), does that mean they might also struggle to compose will well structured and electrically correct circuits, or might struggle to see where existing circuits might have problems? (Or for that matter, have similar difficulties with code and software?)

In all cases, logic, order and perception matter.
i dont think so. logic in circuit or math or SW code is quite different from logic in language... logic in circuit or math (most technical, science or engineering fields) we only have very few, or maybe only one way to get it correct (objective and... provable too) but language is quite subjective imho (too many cultures, languages and words ordering and innovations and intentions). i always treat or think language as a very common mean since stone age in "communication" and there are many ways of conveying it.. but utmost important is the message is decoded by the receiver correctly even if the sender has to find an uncomfortable way of encoding the message in the first place... the trick is to minimize "noises" as much as possible. in context of recent events, noises can be:

1) short forms or broken grammars incomprehensible to the receivers.
2) simply non english, i saw one thread with even incomprehensible characters (german? russia?)

there are more that can be said philosophically and it will be endless imho. i wont type too long into communication theory, you people can and should think for yourself, reading intro in communication theory may helps if you can think holistically too. ymmv.


Nature: Evolution and the Illusion of Randomness (Stephen L. Talbott): Its now indisputable that... organisms “expertise” contextualizes its genome, and its nonsense to say that these powers are under the control of the genome being contextualized - Barbara McClintock
 

Offline tggzzz

  • Super Contributor
  • ***
  • Posts: 19447
  • Country: gb
  • Numbers, not adjectives
    • Having fun doing more, with less
Re: Why writing style and grammar matters in posts
« Reply #4 on: April 11, 2024, 08:39:55 pm »
Supposing someone struggles to compose well structured and grammatically correct sentences (in any language), does that mean they might also struggle to compose well structured and electrically correct circuits, or might struggle to see where existing circuits might have problems? (Or for that matter, have similar difficulties with code and software?)

Possibly, maybe probably, but not necessarily. It will depend on the underlying cause.

If dementia, stroke, illness, etc, then that is the way to bet. But there can be some forms of, ahem, neurodivergence which manifest themselves as capability in one domain but not another.

And, of course, we've all seen people that function well in most respects, but who should be kept well away from keyboards and soldering irons.

Summary: it is suggestive, but other evidence is needed.The

I will not comment on whether I feel there is such evidence.
There are lies, damned lies, statistics - and ADC/DAC specs.
Glider pilot's aphorism: "there is no substitute for span". Retort: "There is a substitute: skill+imagination. But you can buy span".
Having fun doing more, with less
 

Offline John Coloccia

  • Super Contributor
  • ***
  • Posts: 1212
  • Country: us
Re: Why writing style and grammar matters in posts
« Reply #5 on: April 11, 2024, 08:48:42 pm »
How about we treat people like humans and everyone just do their best to have good conversations?
 

Offline tggzzz

  • Super Contributor
  • ***
  • Posts: 19447
  • Country: gb
  • Numbers, not adjectives
    • Having fun doing more, with less
Re: Why writing style and grammar matters in posts
« Reply #6 on: April 11, 2024, 08:57:18 pm »
How about we treat people like humans and everyone just do their best to have good conversations?

Yes.

It, of course, requires all involved to think of the other participants, and to help them not hinder them.

It becomes difficult when participants repeatedly hinder rather than help.
There are lies, damned lies, statistics - and ADC/DAC specs.
Glider pilot's aphorism: "there is no substitute for span". Retort: "There is a substitute: skill+imagination. But you can buy span".
Having fun doing more, with less
 
The following users thanked this post: BrokenYugo

Offline John Coloccia

  • Super Contributor
  • ***
  • Posts: 1212
  • Country: us
Re: Why writing style and grammar matters in posts
« Reply #7 on: April 12, 2024, 03:15:00 am »
How about we treat people like humans and everyone just do their best to have good conversations?

Yes.

It, of course, requires all involved to think of the other participants, and to help them not hinder them.

It becomes difficult when participants repeatedly hinder rather than help.

FWIW, there is almost always too much EGO in conversations online. Sometimes from the asker, often from the replier.

Even when there's not, it's difficult to convey tone of conversation, especially when English isn't the native language. And even when it is and I grew up in New York, and others grew up in London, or Toronto, or Sydney or Sweden, etc...

But it's always up to the guy replying to take things in a good way...or a bad way....and escalate or not. Why ever escalate and be negative over something as silly as grammar, or a beginner question...in the BEGINNERS forum, right? :)
« Last Edit: April 12, 2024, 03:19:30 am by John Coloccia »
 
The following users thanked this post: eTobey

Offline EEVblog

  • Administrator
  • *****
  • Posts: 37717
  • Country: au
    • EEVblog
Re: Why writing style and grammar matters in posts
« Reply #8 on: April 12, 2024, 03:37:14 am »
Thanks. Set to Sticky.
 

Offline Smokey

  • Super Contributor
  • ***
  • Posts: 2564
  • Country: us
  • Not An Expert
Re: Why writing style and grammar matters in posts
« Reply #9 on: April 12, 2024, 03:44:59 am »
Agreed.  Communication is super important....
Lets start with all agreeing on how to pronounce "Bode"...  :)

...
Once again, I apologize for the wall of text.  The more important and/or many-sided I think the issue is, the more verbose I get.  It is a fault of mine I'm working on....
chatGPT is really good at summarizing text.  If you are serious, you can ask chatgpt to distill some long text while retaining the important information. 
« Last Edit: April 12, 2024, 03:47:39 am by Smokey »
 

Offline IanB

  • Super Contributor
  • ***
  • Posts: 11849
  • Country: us
Re: Why writing style and grammar matters in posts
« Reply #10 on: April 12, 2024, 03:49:03 am »
Lets start with all agreeing on how to pronounce "Bode"...  :)

We could always write it down, and thus avoid pronouncing it  :)

But in case it helps, it is a Dutch name, so: https://en.bab.la/pronunciation/dutch/bode
 

Offline floobydust

  • Super Contributor
  • ***
  • Posts: 6956
  • Country: ca
Re: Why writing style and grammar matters in posts
« Reply #11 on: April 12, 2024, 03:50:56 am »
How about we treat people like humans and everyone just do their best to have good conversations?

Yes.

It, of course, requires all involved to think of the other participants, and to help them not hinder them.

It becomes difficult when participants repeatedly hinder rather than help.

FWIW, there is almost always too much EGO in conversations online. Sometimes from the asker, often from the replier.

Even when there's not, it's difficult to convey tone of conversation, especially when English isn't the native language. And even when it is and I grew up in New York, and others grew up in London, or Toronto, or Sydney or Sweden, etc...

But it's always up to the guy replying to take things in a good way...or a bad way....and escalate or not. Why ever escalate and be negative over something as silly as grammar, or a beginner question...in the BEGINNERS forum, right? :)

Other electronics forums will lock a thread if the OP is deemed to unable to work on the project, if it's beyond their ability to stay safe.
Just had an example of a beginner thread, essential details missing, and a safety hazard exists.
Be nice about it? I say no, after several hundred posts you should know better to include a pic, make/model number, some bits of a schematic, a voltage measurement.
Instead of pissing off people trying to answer a vague, volatile thread.

We would deny them the lesson to communicate better, by being all so accommodating and nicey nice.
 

Offline bdunham7

  • Super Contributor
  • ***
  • Posts: 7811
  • Country: us
Re: Why writing style and grammar matters in posts
« Reply #12 on: April 12, 2024, 03:51:34 am »
i dont think so. logic in circuit or math or SW code is quite different from logic in language... logic in circuit or math (most technical, science or engineering fields) we only have very few, or maybe only one way to get it correct (objective and... provable too) but language is quite subjective imho (too many cultures, languages and words ordering and innovations and intentions).

Language barriers are one thing, but assuming the issues are not being lost in translation I have found that people that struggle to express an idea often don't have a very firm grasp on it in the first place.  The true issues really aren't grammatical, they're the missing crucial bits of information that the poster doesn't provide and sometimes even becomes annoyed about when someone asks for them.  I sometimes get in that hair-on-fire knob-twiddling too-much-junk-on-the-bench mode and make mistakes, overlook obvious things and forget to write down measurements.  But before I post for help or discussion I do my best to organize my thoughts and results.  Sometimes just doing that solves the issue and no post is needed. 
« Last Edit: April 12, 2024, 04:02:50 pm by bdunham7 »
A 3.5 digit 4.5 digit 5 digit 5.5 digit 6.5 digit 7.5 digit DMM is good enough for most people.
 

Offline bdunham7

  • Super Contributor
  • ***
  • Posts: 7811
  • Country: us
Re: Why writing style and grammar matters in posts
« Reply #13 on: April 12, 2024, 03:55:50 am »
Lets start with all agreeing on how to pronounce "Bode"...  :)

That's easy.  It rhymes with "Rohde".  :)
A 3.5 digit 4.5 digit 5 digit 5.5 digit 6.5 digit 7.5 digit DMM is good enough for most people.
 

Online Mechatrommer

  • Super Contributor
  • ***
  • Posts: 11612
  • Country: my
  • reassessing directives...
Re: Why writing style and grammar matters in posts
« Reply #14 on: April 12, 2024, 06:30:56 am »
I sometimes get in that hair-on-fire knob-twiddling too-much-junk-on-the-bench mode and make mistakes, overlook obvious things and forget to write down measurements.  But before I post for help or discussion I do my best to organize my thoughts and results.  Sometimes just doing that solves the issue and no post is needed. 
+1 sometime happened to me as well..
Nature: Evolution and the Illusion of Randomness (Stephen L. Talbott): Its now indisputable that... organisms “expertise” contextualizes its genome, and its nonsense to say that these powers are under the control of the genome being contextualized - Barbara McClintock
 

Online Nominal AnimalTopic starter

  • Super Contributor
  • ***
  • Posts: 6227
  • Country: fi
    • My home page and email address
Re: Why writing style and grammar matters in posts
« Reply #15 on: April 12, 2024, 11:46:56 am »
I believe restructuring ones thoughts by putting it in clear understandable written language is a very important tool we can and need to use.

In software development, this is called rubber duck debugging.

In similar vein, putting the effort into structure and grammar (and explaining any abbreviations and rarer technical terms) is not just treating others as you'd like to be treated; it also shows the asker has spent the effort to solve the problem themselves, by ensuring their own understanding is deep enough to explain the problem in as clear writing style and good grammar as they can muster.

Thus, it does not matter if the asker has dyslexia or similar limitations.  The effort in itself is key, because it affects everyone, including the asker themselves.

If we also consider the added benefits of others reading the topic later, and building new understanding and knowledge on top, and sharing that in their own questions and answers, we all win, a lot, in the long term.  I love seeing those I've helped exceed my own capabilities, because it means I've helped create a world with better and more interesting people, things, and opportunities than I myself could create.  My practical experience alone tells me the effort needed is easily, definitely, worth the results.
 
The following users thanked this post: tggzzz


Share me

Digg  Facebook  SlashDot  Delicious  Technorati  Twitter  Google  Yahoo
Smf