Featured

User Interface Developers: Please Have Mercy on Your Poor Users!

Woman screaming in rage,

This blog post is for any software engineers who are involved in programming or designing a user interface.

If someone performs a user interface action that should result in an instantaneous and clearly visible response they will only wait patiently for that response for a brief period of time.

If after a five second delay they do not see the expected clearly visible response they will perform the user interface action again, perhaps multiple times if the delay continues for another five seconds or so.

If for some reason there is a delay that prevents the expected instantaneous and clearly visible response, please, for the love of whatever deity or great power you follow, DO NOT PERFORM THE RESPONSE MULTIPLE TIMES.

The multiple user interface actions were not in any way a request to perform the response multiple times. They were multiple increasingly desperate attempts to get the response a single time.

For example, if the user is pressing enter on a desktop icon that starts a program that displays a message box before the main function is even called, they will press enter on the desktop icon multiple times if for some reason it takes between five and sixty seconds to start the application when it normally starts in far less than a second.

Trust me. The user has already started screaming at you by the time they have to hit enter on the desktop icon a third time because the message box still has not been displayed in response to the request to start the application that was made fifteen seconds earlier.

If you then start that application one time for each time they pressed the enter key on the desktop icon when your badly broken operating system finally realizes the user is desperately trying to start it the poor user might end up having a stroke because of the rage they are now experiencing!

Another example is opening a menu such as the start menu or an application menu. Normally this is a very quick operation that takes less than a second. So if five seconds after they pressed the key to open the menu the user does not see the menu, they will press the key to open it again. On the rare occasions when something delays the opening of the menu they may have pressed the open menu key four or five times before it is opened.

That does not mean they want the menu to be opened, then closed, then opened, then closed…

The multiple presses of the key to open the menu were multiple increasingly desperate attempts to open the menu once. By the second attempt the poor user is screaming at you. If you do the open menu, close menu, open menu, close menu, … foolishness it is very likely that the poor user might end up have a stroke because of the rage they are now experiencing!

These are problems I experience very often with Microsoft Windows. To be fair I have seen it with Linux and Mac OSX as well, but no where near as often as I see in in Windows.

Fuck you very much Microsoft for the wonderful user experience of Windows and every single Microsoft product I have every used! If I believed in hell I would wish for everyone responsible for these wonderful user experiences to suffer eternal torment in the hottest and most fiery section of hell!

Thank you for listening to me vent. I feel much better now.

Here is a song that expresses my heartfelt feelings towards Microsoft. Enjoy.

… you very much Microsoft
Featured

On the benefits of taking a course over learning by doing.

I am a self taught software engineer. It is something I take a great deal of pride in.

I started learning C programming language back in 1997. If I remember correctly I started by reading Sams Teach Yourself C in 21 Days and perhaps also C Programming Language by Brian W. Kernighan and Dennis M. Ritchie.

Then on January 5, 1999 I got a job working for Henter-Joyce (now Freedom Scientific) as an Associate Software Engineer. My responsibilities included writing code in the JAWS Scripting Language which a proprietary programming language that is used by the JAWS screen reader.

I quickly decided that I was not content with just writing code in the JAWS Scripting Language; I wanted to be able to modify the JAWS internals.

At that time almost all of the JAWS internal code was in the C++ programming language. Therefore I decided to teach myself C++.

To learn C++ I did the following.

  • I bought a copy of Sams Teach Yourself C++ in 21 Days and began reading it.
  • I wrote an application called SysInfo in C++ as a aid to our technical support department. SysInfo would gather information such as Video Card information, OS, memory, and send it to technical support via email. SysInfo was very similar to the current Microsoft System Information Tool.

This plan was so successful that I was promoted to Software Engineer in January 2000. I have used C++ as my primary programming language since then.

I never stopped learning. I have tried to keep up to date with new language standards and new technologies since then. But I always learned by doing. If the task I was working on required that I learn something new I would use Google and Stack Overflow and get the job done.

This has been my preferred method of gaining new knowledge until very recently.

On August 1, 2021 my knowledge of JavaScript was minimal. The last time I needed to use JavaScript as part of my job it took me two weeks to fix a bug that required that I change fewer than 10 lines of code.

Then I realized that there are some serious flaws with a browser extension for Google Chrome and Mozilla Firefox released by my employer that I am currently responsible for maintaining that necessitated a complete rewrite of the extension. I tried to make the necessary changes and found much to my horror that I could not even get started.

I had previously bought a lifetime membership to Eduonix and some courses on Udemy with the vague idea of taking the courses some day. However, I had made very minimal use of these educational resources.

I let my employer know what was going on and I was given permission to spend some time when I would normally be working on taking courses in JavaScript. I then spent every day for the next two weeks learning JavaScript.

In just four hours this Monday I rewrote one quarter of the Browser Extension. There is only one reason I did not finish the project; I was temporarily reassigned to another project.

I am not claiming that my knowledge of JavaScript is anywhere near my knowledge of C++. However, after just two weeks my knowledge of JavaScript is roughly equivalent to my knowledge of C++ back in 2001.

Looking back, I find myself wishing that I had followed a more structured approach to learning C++ back in the halcyon days of yore.

Featured

JAWS Scripting Tip: Optional Parameters

JAWS is a screen reader developed by Freedom Scientific. It includes a scripting language that allows users to customize the behavior of JAWS.

Many programming languages such as C++, C#, and Modern JavaScript support the concept of optional function parameters for which you supply a default value for the parameter. In C++ this might be done as follows.

std::wstring GetFavoriteNumberMessage(int64_t number = 42)
{
    std::wstringstream message;
    message
        << L"Hello. My favorite number is "
        << number
        << L". What is your favorite number?\n";
    return message.str();
}

See source on godbolt.org.

The JAWS scripting language supports optional parameters using the optional keyword, as follows.


string function GetFavoriteNumberMessage(optional int number)
  var string message = FormatString(
    "Hello. My favorite number is %1. What is your favorite number?",
     number)
  return message
endFunction

However, there is no direct method of assigning a default value for the optional parameter. If you were to call the function is as without specifying a value for the number parameter the number will be inserted into the returned message as an empty string. This is most likely not the desired behavior.

When the caller does not specify the value of an optional parameter, it does not resolve to 0 or false within the function; this is a common misconception. Instead the unspecified parameter resolves to nullptr. The misconception that the unspecified parameter resolves to 0 or false is a result of the fact that when nullptr is typecast to an int the result is 0 or false. However, if the unspecified parameter is typecast to a string the result is an empty string. This is why in the above example the number will be inserted into the returned message as an empty string; the number parameter is typecast to a string by the FormatString function. If the unspecified parameter did resolve to 0 or false within the function it would be inserted to the returned message as 0!

This problem can be resolved as follows.

string function GetFavoriteNumberMessage(optional int number)
    if (!DidCallerSpecifyTheValueOfTheParameter(number))
      number = 42
    endIf
    var string message = FormatString(
      "Hello. My favorite number is %1. What is your favorite number?",
      number)
    return message
endFunction

Unfortunately, there is no DidCallerSpecifyTheValueOfTheParameter function in the JAWS scripting language, so do not bother looking it up. However, there is a function that can achieve the same goal.

Behind the scenes all variables in the JAWS scripting language are VARIANTs (yes we are aware that there are modern alternatives that are vastly superior but the JAWS scripting language is very old; it has its roots in the JAWS macro language that was included in JAWS for DOS). One benefit of a VARIANT is it supports the concept of a VARTYPE or variant type. Furthermore, there is a VT_EMPTY variant type. Finally, there is a rarely used GetVariantType built-in script function that “determines the type of a variable”.

Thus, it is possible to assign a default value for an optional parameter as follows.

string function GetFavoriteNumberMessage(optional int number)
    if (GetVariantType(number) == VT_EMPTY)
      number = 42
    endIf
    var string message = FormatString(
      "Hello. My favorite number is %1. What is your favorite number?",
      number)
    return message
endFunction

Note that some people may think this is unnecessary because it is enough to rely on the perceived unspecified parameter resolves to 0 or false behavior. This is wrong for two reasons.

  • As I have already pointed this perceived behavior is not what is actually happening. The unspecified parameter actually resolves to nullptr.
  • In many cases, even if the perceived unspecified parameter resolves to 0 or false behavior may not be what is desired.

Every other programming language that supports the concept of optional parameters; such as C++, C#, and Modern JavaScript ; allows the value of the optional parameters to be explicitly defined. The purpose of the following code block is to add the same capabilities to optional parameters in the JAWS Scripting Language.

if (GetVariantType(number) == VT_EMPTY)
  number = 42
endIf

This is the only way to assign a non nullptr value for an optional parameter in the JAWS Scripting Language. You should consider doing this even for parameters where the default value is 0 or nullptr because explicitly specifying the value of your default parameters rather that making people who read your code guess what the behavior will be is just being polite.

Note that using this technique is absolutely necessary when overriding a built-in script function such as the SayObjectTypeAndText function in your scripts. The default value of the includeContainerName is true, not false. Failure to do this when overriding the SayObjectTypeAndText function will change the behavior of your function from the default resulting in hard to find bugs.

Featured

More advice on how to organize an article

The Upcoming changes to Google Drive sync clients page is another excellent example of how not to organize an article.

The section How Backup and Sync users can start using Drive for desktop begins as follows: “To get started with Drive for desktop, you can move your accounts and settings from Backup and Sync to Google Drive for desktop”. At this point the more impatient readers will have already started screaming at the author of this page because no information at all on how to get started was provided. Just above this paragraph is a link to “download Drive for Desktop” so you can assume that by the time your reader gets to this point on the page they have downloaded the software and they are continuing to read the page in order to find out what to do next.

To be more precise, at this point the reader has two questions that they are eager to learn the answer to.

  1. Do I uninstall Backup and Sync first?
  2. Or do I just install Drive for Desktop without first uninstalling Backup and Sync?

In the sentence “To get started with Drive for desktop, you can move your accounts and settings from Backup and Sync to Google Drive for desktop” you have not provided an answer to that question. You have instead annoyed the hell out of your reader. The reader is now screaming “But exactly how do I get started” at the top of their lungs.

The second sentence does not make matters any better: “During the process, you’ll review and confirm the settings for the folders on your computer you’re backing up and syncing with the cloud through Backup and Sync”. The reader is now two thirds of the way through the paragraph and they still have no idea what the answers to the above two questions are.

The final sentence does provide an answer to the question but only indirectly: “Backup and Sync will be automatically uninstalled after you’ve moved your accounts to Drive for desktop”. This sentence implies the answers to the two questions are as follows.

  1. Do I uninstall Backup and Sync first?: No
  2. Or do I just install Drive for Desktop without first uninstalling Backup and Sync?: Yes

The problem is that the impatient reader may have rage quit reading the page before getting this fare because of the issues with the first two sentences in the paragraph. I know that the first time I read this page, while I did manage to restrain myself from screaming, I did rage quit reading the page before I got to this critical sentence. It was not until I returned to the page the following day that I was able to answer my questions.

If a single sentence were added to the start of this paragraph things would be much better for the impatient reader: “You do not need to uninstall Backup and Sync before installing Drive for desktop”.

If the How Backup and Sync users can start using Drive for desktop section were rewritten as follows, this page would be far more useful and far easier to read.

How Backup and Sync users can start using Drive for desktop

You do not need to uninstall Backup and Sync before installing Drive for desktop. To get started with Drive for desktop simply run the Google Drive for desktop installer, GoogleDriveSetup.exe. After the installation of Drive for desktop completes a Move accounts to Drive for desktop form will be displayed to allow you to move your accounts and settings from Backup and Sync to Google Drive for desktop. During the process, you’ll review and confirm the settings for the folders on your computer you’re backing up and syncing with the cloud through Backup and Sync. Backup and Sync will be automatically uninstalled after you’ve moved your accounts to Drive for desktop.

Featured

Advice on how to organize an article

The article What causes the ‘Your Hardware Settings Have Changed’ issue on Windows 10? is very poorly organized.

In the introduction the article explains two possible causes of the issue. This introduction is well written and provides useful, and relevant, information.

After the introduction is a Note heading. The first paragraph in this section begins as follows: “If the given solutions don’t work for you, you will have to stop Windows from updating your device drivers”.

At this point many readers will begin screaming at you in rage because you have not said a single word about how to solve the problem, you just explained what is causing the problem.

Next comes several paragraphs that explain how to “stop Windows from updating your device drivers”.

This Note section ends with the ominous warning: here be dragons. The problem is that the impatient reader who is desperately trying to get their laptop working again may never even get this far because they may have followed the instructions on how to “stop Windows from updating your device drivers” and seeing that the issue has gone away closed the web page.

It is only if you continue scrolling down the page past the ominous warning that you find the solutions. Of course some readers will never see the solution because they stopped reading after following the instructions to “stop Windows from updating your device drivers”.

This article should have been organized as follows.

  1. Causes
  2. Solutions
  3. If the given solutions don’t work for you…

The way the article is presented just pisses the reader off. It may also cause them to try the alternative without ever being aware that the article actually does suggest solutions.

Don’t be like Kevin. Please use a logical order for your articles.

Advice on writing a clear and correct technical article.

Woman screaming in rage,

Please, if you are writing an article like Git Fixes: The Current Branch Has No Upstream Branch in which you attempt to explain how to solve the “fatal: The current branch has no upstream branch” error, do not use the wrong branch name in your sample commands.

For example, do not claim that the problem can be solved with the following command.

git push -u origin master

This error cannot in any way be solved by the above command. Why? Because as you correctly point out in the beginning of your article, the reader is not working in the master branch. The only reason the reader saw the error in the first place and did a Google search to find your article is they created a local branch that is most definitely not named master and an error occurred when they attempted to push the changes. The above command is only valid if they are working in the master branch.

The moment the reader sees master in the above command when they know for a fact that it is not correct the begin to question you credibility.

You started off so well in the third paragraph when you included the following.

git push --set-upstream origin <branchname>

In the above example <branchname> makes it clear that the reader is supposed to insert the name of their own branch in that location in the command.

You started off so well. But then you messed up by putting master where you should have put <branchname> throughout the rest of the article. The moment a reader sees master where they know for a fact that it does not belong, your poor reader may go to another less detailed source rather than figure out what you meant to say. I had to read ten other less well written articles before I figured out what you meant to say.

Reading your article could have been a pleasurable experience causing me to be thankful that the solution was so easily found and implemented. Instead it became an hour long headache.

Computer manufacturers and computer accessory manufacturers really need to use consistent terminology.

Frustrated woman. From pxfuel.com.

Computer manufacturers and computer accessory manufacturers really need to use consistent terminology. Their failure to do so makes things unnecessarily difficult.

I am considering buying a computer from Dell since one of my main computers does not support Windows 11. According to Dell the computer has the following display ports: 1x HDMI 2.0b, 1x DisplayPort 1.4, 1x Dual Link DVI.

The problem is that I need to be able to use this computer with an existing KVM that uses VGA. Therefore I will need to use adapters. The question is what adapters do I need.

Computer accessory manufacturers do not use the Dual Link DVI terminology at all. They use DVI-D and DVI-I. In order to determine what adapter to get I had to go to the Different types of monitor ports page and compare the pictures on Dell.com with the pictures on the Different types of monitor ports page to determine that Dual Link DVI is apparently the same as DVI-D. Therefore the Active DVI-D to VGA Adapter should allow me to connect a VGA monitor cable to the Dual Link DVI port.

Computer accessory manufactures do use the term HDMI. The problem is that not one of the search results for HDMI 2.0b to VGA adapter say anything about the HDMI version. They are HDMI to VGA adapters. No version number information is provided at all. I have to hope that the Gold-Plated HDMI to VGA Adapter will do the job.

Thanks to the use of inconsistent terminology buying this computer has been an arduous and very unpleasant experience.

Thank you very much!

The start of a journey to become my true self.

The long and winding road, taken 14 years ago, 4 km from Dodburn, Scottish Borders, Great Britain.

I am a trans woman. I have been living as a woman for sixteen years. It has been almost sixteen years since I last wore men’s clothing.

And yet I have not begun the gender transitioning process.

I finally decided to begin the gender transitioning process at the end of last year. On December 30, 2020 I did some research to determine how to go about it. I found a document on my health insurance provider’s website containing the following information: “Hormone therapy is usually initiated upon referral from a qualified mental health professional … competent in behavioral health and gender dysphoria treatment”. I also learned that my insurance provider provides various telehealth options for Sexual Orientation and Gender Identity Counseling.

So, on December 31, 2020 I scheduled an appointment with a service called MDLIVE for January 20, 2021 at 1:00 PM CST.

The appointment on January 20, 2021 was a disappointment. At the beginning of the appointment I was asked what my goals are. When I mentioned that my ultimate goal was to begin HRT I was informed the MDLIVE cannot assist with that. The therapist suggested I contact my insurance provider to request information on how to go about starting HRT.

So later that day I used the chat feature of my health insurance provider’s website to request information on how to go about starting HRT. The response was devastating: “I apologize yet Hormone replacement therapy is not a covered benefit under your medical plan since it is considered as experimental, investigation and unproven.”

I was devastated.

Fortunately my health insurance provider has this new program in which they assign their customers a Nurse Case Manager.

I was contacted by two Nurse Case Managers today.

The first Nurse Case Manager I was assigned is not familiar with Gender Dysphoria. When I mentioned to her that I am a trans woman and I am planning on starting HRT soon I was reassigned to another Nurse Case Manager who is familiar with Gender Dysphoria.

My Nurse Case Manager is named Spring.

I mentioned to Spring that I had been informed that hormone replacement therapy is not a covered benefit and she reassured me that Hormonal therapy is covered under their “Treatment of Gender Dysphoria” policy. She sent me their Gender Dysphoria Policy document.

In the document the following services are listed as “Medically necessary treatment for an individual with gender dysphoria”.

  • Behavioral health services
  • Hormonal therapy
  • Gender Reassignment Surgery (with some exceptions) including “Male to female reconstructive genital surgery”.

Unfortunately some services that are deemed to be “not medically necessary service” are not covered. This includes the following.

  • Facial Feminization
  • Breast augmentation
  • Voice therapy

I have requested a referral to an endocrinologist from my Primary Care physician. They have referred me to Texas Diabetes & Endocrinology and I should be contacted by them next week. Spring confirmed that Texas Diabetes & Endocrinology accepts my health insurance and they are considered to be an in-network provider.

In other words, I am finally becoming my true self at the age of 44. I am so happy.

It has taken me many years and a great deal of pain to get to this point.

When I was a child my parents did everything they could to beat masculinity into me (see Do not try to force boys to be masculine. You will only break them.). They kept me from even realizing that there was an option to being a man. This is why I emphasize with what Vanyel Ashkevron went through in the book Magic’s Pawn: Valdemar: The Last Herald Mage; in this book Vanyel’s weapons master and father went to great lengths to keep Vanyel from realizing that homosexual relationships were possible.

I was married, to a woman, before I ever heard the word transgender.

When I finally accepted that I am transgendered, it ruined my marriage. The first thing my wife said to me was “I did not marry a woman.” She then accused me of marrying her under false pretenses.

It has been a long, winding, and extremely painful road. Everyone in my life who should have helped me instead put up road blocks. But I am finally here.

My response to a recent tweet by @realDonaldTrump.

Today @realDonaldTrump tweeted the following.

Donald J. Trump
@realDonaldTrump
At 10:00 P.M. on Election Evening, we were at 97% win with the so-called “bookies”.

This tweet has 146.8K Likes.

The problem is that this was in fact expected and is not evidence of fraud or proof that the election results are invalid for the following reasons which I will explain in the simplest way possible.

  1. There is a currently a deadly worldwide pandemic.
  2. Voting in person during a pandemic is a health risk.
  3. Many states responded to the pandemic by encouraging Vote by Mail.
  4. In many states the law required that counting of vote by mail ballots not begin until after the election.
  5. You told your supporters that vote by mail is prone to fraud despite having no proof. Thus many of your supporters chose to vote in person despite the pandemic related health risk.
  6. Democrats encouraged to stay healthy and vote by mail. Thus many democrats did the sane thing and chose to Vote by Mail.

Thus the inevitable result is that at the end of the day the election results appeared to favor Donald Trump because the legal vote by mail ballots had not been counted yet.

Even Attorney General William Barr, a well known supporter of Donald Trump, has said that “to date, we have not seen fraud on a scale that could have effected a different outcome in the election.”