From 99f1d1fa010d22f2a2220f2e647fc7995f9fd38d Mon Sep 17 00:00:00 2001 From: Eric Harding Date: Wed, 6 Feb 2019 14:48:18 -0500 Subject: [PATCH] Review feedback --- doc/sdk/ApiThreading.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/sdk/ApiThreading.md b/doc/sdk/ApiThreading.md index 9b8b05a33..1ca91214b 100644 --- a/doc/sdk/ApiThreading.md +++ b/doc/sdk/ApiThreading.md @@ -1,5 +1,5 @@ -# API Threading +# API Client Threading BTS API provides two types of calls. There are RPC (remote procedure calls) which accept an argument and return a value and there are streams of tabular data which we call subscriptions. All communication to and from the server happens on a connection thread owned by the ServiceContext object and data must be marshaled back to the right context when the call is complete. @@ -7,7 +7,7 @@ BTS API provides two types of calls. There are RPC (remote procedure calls) whi ### C# -All API calls provide both a synchronous and [asynconous](https://docs.microsoft.com/en-us/dotnet/csharp/language-reference/keywords/async) version. If you are calling the API from a WPF or Windows Forms application you should always prefer the async version of the method because it will efficiently make the call and resume execution on the correct thread without blocking or lagging user interactions. The syncronous calls are intended for use in console applications where nothing else needs use of the thread until the data is available. +All API calls provide both a synchronous and [asynchronous](https://docs.microsoft.com/en-us/dotnet/csharp/language-reference/keywords/async) version. If you are calling the API from a WPF or Windows Forms application you should always prefer the async version of the method because it will efficiently make the call and resume execution on the correct thread without blocking or lagging user interactions. The synchronous calls are intended for use in console applications where nothing else needs use of the thread until the data is available. The async version of the method will return a `Result` type which is used to signal if an error occurred during the call. You should test the Result.success to see if the call succeeded before using Result.value.