Marking deprecated APIs as Obsolete and updating readme

Resolves #63

SlackNet/SlackApiClient.cs

@@ -18,6 +18,7 @@ public interface ISlackApiClient
         IAppsEventsAuthorizationsApi AppsEventsAuthorizations { get; }
         IAuthApi Auth { get; }
         IBotsApi Bots { get; }
+        [Obsolete("Use Conversations instead")]
         IChannelsApi Channels { get; }
         IChatApi Chat { get; }
         IConversationsApi Conversations { get; }
@@ -26,9 +27,12 @@ public interface ISlackApiClient
         IEmojiApi Emoji { get; }
         IFileCommentsApi FileComments { get; }
         IFilesApi Files { get; }
+        [Obsolete("Use Conversations instead")]
         IGroupsApi Groups { get; }
+        [Obsolete("Use Conversations instead")]
         IImApi Im { get; }
         IMigrationApi Migration { get; }
+        [Obsolete("Use Conversations instead")]
         IMpimApi Mpim { get; }
         IOAuthApi OAuth { get; }
         IPinsApi Pins { get; }

SlackNet/WebApi/ChannelsApi.cs

@@ -1,3 +1,4 @@
+using System;
 using System.Collections.Generic;
 using System.Threading;
 using System.Threading.Tasks;
@@ -6,6 +7,7 @@
 
 namespace SlackNet.WebApi
 {
+    [Obsolete("Use IConversationsApi instead")]
     public interface IChannelsApi
     {
         /// <summary>
@@ -64,8 +66,8 @@ public interface IChannelsApi
         /// <param name="cancellationToken"></param>
         /// <returns>
         /// If successful, the command returns a channel object, including state information.
-        /// If you are already in the channel, the response is slightly different. 
-        /// <see cref="ChannelJoinResponse.AlreadyInChannel"/> will be true, and a limited channel object will be returned. 
+        /// If you are already in the channel, the response is slightly different.
+        /// <see cref="ChannelJoinResponse.AlreadyInChannel"/> will be true, and a limited channel object will be returned.
         /// This allows a client to see that the request to join GeNERaL is the same as the channel #general that the user is already in.
         /// </returns>
         Task<ChannelJoinResponse> Join(string channelName, bool validate = false, CancellationToken? cancellationToken = null);
@@ -87,8 +89,8 @@ public interface IChannelsApi
         Task Leave(string channelId, CancellationToken? cancellationToken = null);
 
         /// <summary>
-        /// Returns a list of all channels in the team. 
-        /// This includes channels the caller is in, channels they are not currently in, and archived channels but does not include private channels. 
+        /// Returns a list of all channels in the team.
+        /// This includes channels the caller is in, channels they are not currently in, and archived channels but does not include private channels.
         /// The number of (non-deactivated) members in each channel is also returned.
         /// To retrieve a list of private channels, use groups.list.
         /// </summary>
@@ -107,7 +109,7 @@ public interface IChannelsApi
 
         /// <summary>
         /// Renames a team channel.
-        /// The only people who can rename a channel are Team Admins, or the person that originally created the channel. 
+        /// The only people who can rename a channel are Team Admins, or the person that originally created the channel.
         /// Others will receive a "not_authorized" error.
         /// </summary>
         /// <param name="channelId">Channel to rename</param>
@@ -150,6 +152,7 @@ public interface IChannelsApi
         Task Unarchive(string channelId, CancellationToken? cancellationToken = null);
     }
 
+    [Obsolete("Use ConversationsApi instead")]
     public class ChannelsApi : IChannelsApi
     {
         private readonly ISlackApiClient _client;
@@ -235,8 +238,8 @@ public async Task<Channel> Invite(string channelId, string userId, CancellationT
         /// <param name="cancellationToken"></param>
         /// <returns>
         /// If successful, the command returns a channel object, including state information.
-        /// If you are already in the channel, the response is slightly different. 
-        /// <see cref="ChannelJoinResponse.AlreadyInChannel"/> will be true, and a limited channel object will be returned. 
+        /// If you are already in the channel, the response is slightly different.
+        /// <see cref="ChannelJoinResponse.AlreadyInChannel"/> will be true, and a limited channel object will be returned.
         /// This allows a client to see that the request to join GeNERaL is the same as the channel #general that the user is already in.
         /// </returns>
         public Task<ChannelJoinResponse> Join(string channelName, bool validate = false, CancellationToken? cancellationToken = null) =>
@@ -269,8 +272,8 @@ public Task Leave(string channelId, CancellationToken? cancellationToken = null)
             _client.Post("channels.leave", new Args { { "channel", channelId } }, cancellationToken);
 
         /// <summary>
-        /// Returns a list of all channels in the team. 
-        /// This includes channels the caller is in, channels they are not currently in, and archived channels but does not include private channels. 
+        /// Returns a list of all channels in the team.
+        /// This includes channels the caller is in, channels they are not currently in, and archived channels but does not include private channels.
         /// The number of (non-deactivated) members in each channel is also returned.
         /// To retrieve a list of private channels, use groups.list.
         /// </summary>
@@ -300,7 +303,7 @@ public Task Mark(string channelId, string ts, CancellationToken? cancellationTok
 
         /// <summary>
         /// Renames a team channel.
-        /// The only people who can rename a channel are Team Admins, or the person that originally created the channel. 
+        /// The only people who can rename a channel are Team Admins, or the person that originally created the channel.
         /// Others will receive a "not_authorized" error.
         /// </summary>
         /// <param name="channelId">Channel to rename</param>

SlackNet/WebApi/GroupsApi.cs

@@ -1,11 +1,13 @@
-using System.Collections.Generic;
+using System;
+using System.Collections.Generic;
 using System.Threading;
 using System.Threading.Tasks;
 using SlackNet.Events;
 using Args = System.Collections.Generic.Dictionary<string, object>;
 
 namespace SlackNet.WebApi
 {
+    [Obsolete("Use IConversationsApi instead")]
     public interface IGroupsApi
     {
         /// <summary>
@@ -95,7 +97,7 @@ Task<ChannelHistoryResponse> History(
         Task Leave(string channelId, CancellationToken? cancellationToken = null);
 
         /// <summary>
-        /// Returns a list of private channels in the team that the caller is in and archived groups that the caller was in. 
+        /// Returns a list of private channels in the team that the caller is in and archived groups that the caller was in.
         /// The list of (non-deactivated) members in each private channel is also returned.
         /// </summary>
         /// <param name="excludeArchived">Don't return archived private channels.</param>
@@ -161,6 +163,7 @@ Task<ChannelHistoryResponse> History(
         Task Unarchive(string channelId, CancellationToken? cancellationToken = null);
     }
 
+    [Obsolete("Use ConversationsApi instead")]
     public class GroupsApi : IGroupsApi
     {
         private readonly ISlackApiClient _client;
@@ -285,7 +288,7 @@ public Task Leave(string channelId, CancellationToken? cancellationToken = null)
             _client.Post("groups.leave", new Args { { "channel", channelId } }, cancellationToken);
 
         /// <summary>
-        /// Returns a list of private channels in the team that the caller is in and archived groups that the caller was in. 
+        /// Returns a list of private channels in the team that the caller is in and archived groups that the caller was in.
         /// The list of (non-deactivated) members in each private channel is also returned.
         /// </summary>
         /// <param name="excludeArchived">Don't return archived private channels.</param>

SlackNet/WebApi/ImApi.cs

@@ -1,11 +1,13 @@
-using System.Collections.Generic;
+using System;
+using System.Collections.Generic;
 using System.Threading;
 using System.Threading.Tasks;
 using SlackNet.Events;
 using Args = System.Collections.Generic.Dictionary<string, object>;
 
 namespace SlackNet.WebApi
 {
+    [Obsolete("Use IConversationsApi instead")]
     public interface IImApi
     {
         /// <summary>
@@ -69,6 +71,7 @@ Task<ChannelHistoryResponse> History(
         Task<IReadOnlyList<MessageEvent>> Replies(string channelId, string threadTs, CancellationToken? cancellationToken = null);
     }
 
+    [Obsolete("Use IConversationsApi instead")]
     public class ImApi : IImApi
     {
         private readonly ISlackApiClient _client;

SlackNet/WebApi/MpimApi.cs

@@ -1,11 +1,13 @@
-using System.Collections.Generic;
+using System;
+using System.Collections.Generic;
 using System.Threading;
 using System.Threading.Tasks;
 using SlackNet.Events;
 using Args = System.Collections.Generic.Dictionary<string, object>;
 
 namespace SlackNet.WebApi
 {
+    [Obsolete("Use IConversationsApi instead")]
     public interface IMpimApi
     {
         /// <summary>
@@ -68,6 +70,7 @@ Task<ChannelHistoryResponse> History(
         Task<IReadOnlyList<MessageEvent>> Replies(string channelId, string threadTs, CancellationToken? cancellationToken = null);
     }
 
+    [Obsolete("Use IConversationsApi instead")]
     public class MpimApi : IMpimApi
     {
         private readonly ISlackApiClient _client;

readme.md

@@ -14,7 +14,7 @@ var api = new SlackApiClient("<your OAuth access token here>");
 ```
 then start calling methods:
 ```c#
-var channels = await api.Channels.List();
+var channels = await api.Conversations.List();
 ```
 
 To use the RTM API:
@@ -62,7 +62,7 @@ message.ReplyWith(async () => {
 SlackNet.Bot includes a simplified API for getting common information from Slack:
 ```c#
 var user = await bot.GetUserByName("someuser");
-var channels = await bot.GetChannels();
+var conversations = await bot.GetConversations();
 // etc.
 ```
 Everything is cached, so go nuts getting the information you need. You can clear the cache with `bot.ClearCache()`.