updated Intellisense / doc

Author: wiz0u

EXAMPLES.md

@@ -26,7 +26,7 @@ More examples can also be found in the [Examples folder](Examples) and in answer
 var resolved = await client.Contacts_ResolveUsername("MyEch0_Bot"); // username without the @
 await client.SendMessageAsync(resolved, "/start");
 ```
-*Note: This also works if the @username points to a channel/group, but you must already have joined that channel before posting there.
+*Note: This also works if the @username points to a channel/group, but you must already have joined that channel before sending a message to it.
 If the username is invalid/unused, the API call raises an exception.*
 
 <a name="msg-by-phone"></a>
@@ -210,7 +210,7 @@ for (int offset = 0; ;)
 ```
 
 For big Channel/Group, Telegram servers might limit the number of members you can obtain with the normal above method.  
-In this case, you can use this helper method, but it can take several minutes to complete:
+In this case, you can use the following helper method, but it can take several minutes to complete:
 ```csharp
 var chats = await client.Messages_GetAllChats();
 var channel = (Channel)chats.chats[1234567890]; // the channel we want
@@ -233,7 +233,7 @@ To use them, you need to extract the `HASH` part from the URL and then you can u
 ```csharp
 var chatInvite = await client.Messages_CheckChatInvite("HASH"); // optional: get information before joining  
 await client.Messages_ImportChatInvite("HASH"); // join the channel/group  
-// Note: This works also with invite links of public channel/group
+// Note: This works also with hash invite links of public channel/group
 ```
 
 <a name="add-members"></a>
@@ -319,7 +319,7 @@ Your event handler implementation can either return `Task.CompletedTask` or be a
 See [Examples/Program_ListenUpdates.cs](Examples/Program_ListenUpdates.cs).
 
 <a name="monitor-msg"></a>
-### Monitor new messages being posted in chats
+### Monitor new messages being posted in chats in real-time
 
 You have to handle `client.OnUpdate` events containing an `UpdateNewMessage`.
 

Examples/Program_Heroku.cs

@@ -6,7 +6,7 @@
 using System.Threading.Tasks;
 using TL;
 
-// This is an example userbot designed to run on a free Heroku account with a free PostgreSQL database for session storage
+// This is an example userbot designed to run on a Heroku account with a PostgreSQL database for session storage
 // This userbot simply answer "Pong" when someone sends him a "Ping" private message (or in Saved Messages)
 // To use/install/deploy this userbot, follow the steps at the end of this file
 // When run locally, close the window or type ALT-F4 to exit cleanly and save session (similar to Heroku SIGTERM)
@@ -126,8 +126,8 @@ public override void Flush() { }
 
 /******************************************************************************************************************************
 HOW TO USE AND DEPLOY THIS EXAMPLE HEROKU USERBOT:
-- From your free Heroku.com account dashboard, create a new app (Free)
-- Navigate to the app Resources and add the add-on "Heroku Postgres" (Hobby Dev - Free)
+- From your Heroku.com account dashboard, create a new app
+- Navigate to the app Resources and add the add-on "Heroku Postgres"
 - Navigate to the app Settings, click Reveal Config Vars and save the Heroku git URL and the value of DATABASE_URL
 - Add a new var named "api_hash" with your api hash obtained from https://my.telegram.org/apps
 - Add a new var named "phone_number" with the phone_number of the user this userbot will manage
@@ -146,9 +146,7 @@ public override void Flush() { }
 - Paste inside the line you copied, and replace the initial "web" with "worker:" (don't forget the colon)
 - Commit and push the Git changes to Heroku. Wait until the deployment is complete.
 - Verify that the Resources "web" line has changed to "worker" and is enabled (use the pencil icon if necessary)
-- Now your userbot should be running 24/7. Note however that a full month of usage is 31*24 = 744 dyno hours.
-  By default a free account gets 550 free dyno hours per month after which your app is stopped. If you register
-  a credit card with your account, 450 additional free dyno hours are offered at no charge, which should be enough for 24/7
+- Now your userbot should be running 24/7.
 - To prevent AUTH_KEY_DUPLICATED issues, set a SESSION_NAME env variable in your local VS project with a value like "PC"
 DISCLAIMER: I'm not affiliated nor expert with Heroku, so if you have any problem with the above I might not be able to help
 ******************************************************************************************************************************/

FAQ.md

@@ -87,6 +87,7 @@ You can verify this is your issue by looking at [WTelegram logs](EXAMPLES.md#log
 This wrong-server problem typically happens when you use WTelegramClient Github source project in your application in DEBUG builds.  
 It is **not recommended** to use WTelegramClient in source code form.
 Instead, you should use the Nuget manager to **install package WTelegramClient** into your application.
+*And remember to delete the WTelegram.session file to force a new login on the correct server.*
 
 If you use the Github source project in an old .NET Framework 4.x or .NET Core x.x application, you may also experience the following error
 > System.TypeInitializationException (FileNotFoundException for "System.Text.Json Version=5.0.0.0 ...")
@@ -163,7 +164,7 @@ That object must be created with both fields `channel_id` and `access_hash` corr
 There can be several reasons why `chats.chats[id]` raise an error:
 - The user account you're currently logged-in as has not joined this particular chat.  
 API method [Messages_GetAllChats](https://corefork.telegram.org/method/messages.getAllChats) will only return those chat groups/channels the user is in, not all Telegram chat groups.
-- You're trying to use a Telegram.Bot (or TDLib) numerical ID, like -1001234567890  
+- You're trying to use a Bot API (or TDLib) numerical ID, like -1001234567890  
 Telegram Client API don't use these kind of IDs for chats. Remove the -100 prefix and try again with the rest (1234567890).
 - You're trying to use a user ID instead of a chat ID.  
 Private messages with a user are not called "chats". See [Terminology in ReadMe](README.md#terminology).  
@@ -232,7 +233,7 @@ If you need your userbot to run 24/7, you would typically design your userbot as
 and hosted online on any [VPS Hosting](https://www.google.com/search?q=vps+hosting) (Virtual Private Server).  
 Pure WebApp hosts might not be adequate as they will recycle (stop) your app if there is no incoming HTTP requests.
 
-There are many cheap VPS Hosting offers available, and some even have free tier, like Heroku:  
+There are many cheap VPS Hosting offers available, for example Heroku:  
 See [Examples/Program_Heroku.cs](Examples/Program_Heroku.cs) for such an implementation and the steps to host/deploy it.
 
 <a name="troubleshoot"></a>

README.md

@@ -3,7 +3,7 @@
 [![API Layer](https://img.shields.io/badge/API_Layer-144-blueviolet)](https://corefork.telegram.org/methods)
 [![dev nuget](https://img.shields.io/badge/dynamic/json?color=ffc040&label=dev%20nuget&query=%24.versions%5B0%5D&url=https%3A%2F%2Fpkgs.dev.azure.com%2Fwiz0u%2F81bd92b7-0bb9-4701-b426-09090b27e037%2F_packaging%2F46ce0497-7803-4bd4-8c6c-030583e7c371%2Fnuget%2Fv3%2Fflat2%2Fwtelegramclient%2Findex.json)](https://dev.azure.com/wiz0u/WTelegramClient/_artifacts/feed/WTelegramClient/NuGet/WTelegramClient)
 [![Support Chat](https://img.shields.io/badge/Chat_with_us-on_Telegram-0088cc)](https://t.me/WTelegramClient)
-[![Donate](https://img.shields.io/badge/Help_this_project:-Donate-ff4444)](http://wizou.fr/donate.html)
+[![Donate](https://img.shields.io/badge/Help_this_project:-Donate-ff4444)](http://t.me/WTelegramBot?start=donate)
 
 ## _Telegram Client API library written 100% in C# and .NET Standard_
 
@@ -36,7 +36,7 @@ If the verification succeeds but the phone number is unknown to Telegram, the us
 If the account already exists and has enabled two-step verification (2FA) a **password** might be required.  
 All these login scenarios are handled automatically within the call to `LoginUserIfNeeded`.
 
-And that's it, you now have access to the **[full range of Telegram Client APIs](https://corefork.telegram.org/methods)**. 
+After login, you now have access to the **[full range of Telegram Client APIs](https://corefork.telegram.org/methods)**. 
 All those API methods require `using TL;` namespace and are called with an underscore instead of a dot in the method name, like this: `await client.Method_Name(...)`
 
 # Saved session
@@ -162,4 +162,4 @@ Please don't use this library for Spam or Scam. Respect Telegram [Terms of Servi
 Developers feedback is welcome in the Telegram support group [@WTelegramClient](https://t.me/WTelegramClient)  
 You can also check our [📖 Frequently Asked Questions](https://github.com/wiz0u/WTelegramClient/blob/master/FAQ.md) for more help and troubleshooting guide.
 
-If you like this library, please [consider a donation](http://wizou.fr/donate.html).❤ This will help the project keep going.
+If you like this library, please [consider a donation](http://t.me/WTelegramBot?start=donate).❤ This will help the project keep going.

src/Client.cs

@@ -22,7 +22,7 @@ namespace WTelegram
 	public partial class Client : IDisposable
 	{
 		/// <summary>This event will be called when unsollicited updates/messages are sent by Telegram servers</summary>
-		/// <remarks>Make your handler <see langword="async"/>, or return <see cref="Task.CompletedTask"></see><br/>See <see href="https://github.com/wiz0u/WTelegramClient/blob/master/Examples/Program_ListenUpdates.cs">Examples/Program_ListenUpdate.cs</see> for how to use this</remarks>
+		/// <remarks>Make your handler <see langword="async"/>, or return <see cref="Task.CompletedTask"/> or <see langword="null"/><br/>See <see href="https://github.com/wiz0u/WTelegramClient/blob/master/Examples/Program_ListenUpdates.cs">Examples/Program_ListenUpdate.cs</see> for how to use this</remarks>
 		public event Func<IObject, Task> OnUpdate;
 		/// <summary>Used to create a TcpClient connected to the given address/port, or throw an exception on failure</summary>
 		public TcpFactory TcpHandler { get; set; } = DefaultTcpHandler;