Merge pull request #1646 from distributivgesetz/ambiguous-inheritdocs

Fixes ambiguous inheritdocs

src/Tgstation.Server.Client/AdministrationClient.cs

@@ -11,7 +11,7 @@ using Tgstation.Server.Api.Models.Response;
 
 namespace Tgstation.Server.Client
 {
-	/// <inheritdoc />
+	/// <inheritdoc cref="IAdministrationClient" />
 	sealed class AdministrationClient : PaginatedClient, IAdministrationClient
 	{
 		/// <summary>

src/Tgstation.Server.Client/Components/ByondClient.cs

@@ -11,7 +11,7 @@ using Tgstation.Server.Api.Models.Response;
 
 namespace Tgstation.Server.Client.Components
 {
-	/// <inheritdoc />
+	/// <inheritdoc cref="IByondClient" />
 	sealed class ByondClient : PaginatedClient, IByondClient
 	{
 		/// <summary>

src/Tgstation.Server.Client/Components/ChatBotsClient.cs

@@ -10,7 +10,7 @@ using Tgstation.Server.Api.Models.Response;
 
 namespace Tgstation.Server.Client.Components
 {
-	/// <inheritdoc />
+	/// <inheritdoc cref="IChatBotsClient" />
 	sealed class ChatBotsClient : PaginatedClient, IChatBotsClient
 	{
 		/// <summary>

src/Tgstation.Server.Client/Components/ConfigurationClient.cs

@@ -11,7 +11,7 @@ using Tgstation.Server.Api.Models.Response;
 
 namespace Tgstation.Server.Client.Components
 {
-	/// <inheritdoc />
+	/// <inheritdoc cref="IConfigurationClient" />
 	sealed class ConfigurationClient : PaginatedClient, IConfigurationClient
 	{
 		/// <summary>

src/Tgstation.Server.Client/Components/DreamMakerClient.cs

@@ -10,7 +10,7 @@ using Tgstation.Server.Api.Models.Response;
 
 namespace Tgstation.Server.Client.Components
 {
-	/// <inheritdoc />
+	/// <inheritdoc cref="IDreamMakerClient" />
 	sealed class DreamMakerClient : PaginatedClient, IDreamMakerClient
 	{
 		/// <summary>

src/Tgstation.Server.Client/Components/InstancePermissionSetClient.cs

@@ -11,7 +11,7 @@ using Tgstation.Server.Api.Models.Response;
 
 namespace Tgstation.Server.Client.Components
 {
-	/// <inheritdoc />
+	/// <inheritdoc cref="IInstancePermissionSetClient" />
 	sealed class InstancePermissionSetClient : PaginatedClient, IInstancePermissionSetClient
 	{
 		/// <summary>

src/Tgstation.Server.Client/Components/JobsClient.cs

@@ -9,7 +9,7 @@ using Tgstation.Server.Api.Models.Response;
 
 namespace Tgstation.Server.Client.Components
 {
-	/// <inheritdoc />
+	/// <inheritdoc cref="IJobsClient" />
 	sealed class JobsClient : PaginatedClient, IJobsClient
 	{
 		/// <summary>

src/Tgstation.Server.Client/InstanceManagerClient.cs

@@ -11,7 +11,7 @@ using Tgstation.Server.Client.Components;
 
 namespace Tgstation.Server.Client
 {
-	/// <inheritdoc />
+	/// <inheritdoc cref="IInstanceManagerClient" />
 	sealed class InstanceManagerClient : PaginatedClient, IInstanceManagerClient
 	{
 		/// <summary>

src/Tgstation.Server.Client/UserGroupsClient.cs

@@ -10,7 +10,7 @@ using Tgstation.Server.Api.Models.Response;
 
 namespace Tgstation.Server.Client
 {
-	/// <inheritdoc />
+	/// <inheritdoc cref="IUserGroupsClient" />
 	sealed class UserGroupsClient : PaginatedClient, IUserGroupsClient
 	{
 		/// <summary>

src/Tgstation.Server.Client/UsersClient.cs

@@ -10,7 +10,7 @@ using Tgstation.Server.Api.Models.Response;
 
 namespace Tgstation.Server.Client
 {
-	/// <inheritdoc />
+	/// <inheritdoc cref="IUsersClient" />
 	sealed class UsersClient : PaginatedClient, IUsersClient
 	{
 		/// <summary>

src/Tgstation.Server.Host/Components/Byond/ByondExecutableLock.cs

@@ -4,7 +4,7 @@ using Tgstation.Server.Host.Utils;
 
 namespace Tgstation.Server.Host.Components.Byond
 {
-	/// <inheritdoc />
+	/// <inheritdoc cref="IByondExecutableLock" />
 	sealed class ByondExecutableLock : ReferenceCounter<ByondInstallation>, IByondExecutableLock
 	{
 		/// <inheritdoc />

src/Tgstation.Server.Host/Components/Chat/ChatManager.cs

@@ -20,7 +20,7 @@ using Tgstation.Server.Host.Utils;
 
 namespace Tgstation.Server.Host.Components.Chat
 {
-	/// <inheritdoc />
+	/// <inheritdoc cref="IChatManager" />
 	// TODO: Decomplexify
 #pragma warning disable CA1506
 	sealed class ChatManager : IChatManager, IRestartHandler

src/Tgstation.Server.Host/Components/InstanceManager.cs

@@ -27,7 +27,7 @@ using Tgstation.Server.Host.Utils;
 
 namespace Tgstation.Server.Host.Components
 {
-	/// <inheritdoc />
+	/// <inheritdoc cref="IInstanceManager" />
 	sealed class InstanceManager :
 		IInstanceManager,
 		IInstanceCoreProvider,

src/Tgstation.Server.Host/Components/Session/SessionController.cs

@@ -26,7 +26,7 @@ using Tgstation.Server.Host.Utils;
 
 namespace Tgstation.Server.Host.Components.Session
 {
-	/// <inheritdoc />
+	/// <inheritdoc cref="ISessionController" />
 	sealed class SessionController : Chunker, ISessionController, IBridgeHandler, IChannelSink
 	{
 		/// <summary>

src/Tgstation.Server.Host/Core/ServerUpdater.cs

@@ -13,7 +13,7 @@ using Tgstation.Server.Host.Utils.GitHub;
 
 namespace Tgstation.Server.Host.Core
 {
-	/// <inheritdoc />
+	/// <inheritdoc cref="IServerUpdater" />
 	sealed class ServerUpdater : IServerUpdater, IServerUpdateExecutor
 	{
 		/// <summary>

src/Tgstation.Server.Host/IO/Console.cs

@@ -7,7 +7,9 @@ using Tgstation.Server.Host.System;
 
 namespace Tgstation.Server.Host.IO
 {
-	/// <inheritdoc />
+	/// <summary>
+	/// Implementation of <see cref="IConsole"/>, uses <see cref="global::System.Console"/>.
+	/// </summary>
 	sealed class Console : IConsole, IDisposable
 	{
 		/// <inheritdoc />

src/Tgstation.Server.Host/Jobs/JobService.cs

@@ -16,7 +16,7 @@ using Tgstation.Server.Host.Utils;
 
 namespace Tgstation.Server.Host.Jobs
 {
-	/// <inheritdoc />
+	/// <inheritdoc cref="IJobService" />
 	sealed class JobService : IJobService, IDisposable
 	{
 		/// <summary>

src/Tgstation.Server.Host/Models/ChatBot.cs

@@ -6,7 +6,7 @@ using Tgstation.Server.Api.Models.Response;
 
 namespace Tgstation.Server.Host.Models
 {
-	/// <inheritdoc />
+	/// <inheritdoc cref="Api.Models.Internal.ChatBotSettings" />
 	public sealed class ChatBot : Api.Models.Internal.ChatBotSettings, IApiTransformable<ChatBotResponse>
 	{
 		/// <summary>

src/Tgstation.Server.Host/Models/CompileJob.cs

@@ -6,7 +6,7 @@ using Tgstation.Server.Api.Models.Response;
 
 namespace Tgstation.Server.Host.Models
 {
-	/// <inheritdoc />
+	/// <inheritdoc cref="Api.Models.Internal.CompileJob" />
 	public sealed class CompileJob : Api.Models.Internal.CompileJob, IApiTransformable<CompileJobResponse>
 	{
 		/// <summary>

src/Tgstation.Server.Host/Models/DreamMakerSettings.cs

@@ -4,7 +4,7 @@ using Tgstation.Server.Api.Models.Response;
 
 namespace Tgstation.Server.Host.Models
 {
-	/// <inheritdoc />
+	/// <inheritdoc cref="Api.Models.Internal.DreamMakerSettings" />
 	public sealed class DreamMakerSettings : Api.Models.Internal.DreamMakerSettings, IApiTransformable<DreamMakerResponse>
 	{
 		/// <summary>

src/Tgstation.Server.Host/Models/InstancePermissionSet.cs

@@ -4,7 +4,7 @@ using Tgstation.Server.Api.Models.Response;
 
 namespace Tgstation.Server.Host.Models
 {
-	/// <inheritdoc />
+	/// <inheritdoc cref="Api.Models.Internal.InstancePermissionSet" />
 	public sealed class InstancePermissionSet : Api.Models.Internal.InstancePermissionSet, IApiTransformable<InstancePermissionSetResponse>
 	{
 		/// <summary>

src/Tgstation.Server.Host/Models/Job.cs

@@ -4,7 +4,7 @@ using Tgstation.Server.Api.Models.Response;
 
 namespace Tgstation.Server.Host.Models
 {
-	/// <inheritdoc />
+	/// <inheritdoc cref="Api.Models.Internal.Job" />
 #pragma warning disable CA1724 // naming conflict with gitlab package
 	public sealed class Job : Api.Models.Internal.Job, IApiTransformable<JobResponse>
 #pragma warning restore CA1724

src/Tgstation.Server.Host/Models/OAuthConnection.cs

@@ -1,6 +1,6 @@
 namespace Tgstation.Server.Host.Models
 {
-	/// <inheritdoc />
+	/// <inheritdoc cref="Api.Models.OAuthConnection" />
 	public sealed class OAuthConnection : Api.Models.OAuthConnection, IApiTransformable<Api.Models.OAuthConnection>
 	{
 		/// <summary>

src/Tgstation.Server.Host/Models/RepositorySettings.cs

@@ -4,7 +4,7 @@ using Tgstation.Server.Api.Models.Response;
 
 namespace Tgstation.Server.Host.Models
 {
-	/// <inheritdoc />
+	/// <inheritdoc cref="Api.Models.Internal.RepositorySettings" />
 	public sealed class RepositorySettings : Api.Models.Internal.RepositorySettings, IApiTransformable<RepositoryResponse>
 	{
 		/// <summary>

src/Tgstation.Server.Host/Models/RevisionInformation.cs

@@ -4,7 +4,7 @@ using System.Linq;
 
 namespace Tgstation.Server.Host.Models
 {
-	/// <inheritdoc />
+	/// <inheritdoc cref="Api.Models.Internal.RevisionInformation" />
 	public sealed class RevisionInformation : Api.Models.Internal.RevisionInformation, IApiTransformable<Api.Models.RevisionInformation>
 	{
 		/// <summary>

src/Tgstation.Server.Host/Models/TestMerge.cs

@@ -3,7 +3,7 @@ using System.ComponentModel.DataAnnotations;
 
 namespace Tgstation.Server.Host.Models
 {
-	/// <inheritdoc />
+	/// <inheritdoc cref="Api.Models.Internal.TestMergeApiBase" />
 	public sealed class TestMerge : Api.Models.Internal.TestMergeApiBase, IApiTransformable<Api.Models.TestMerge>
 	{
 		/// <summary>

src/Tgstation.Server.Host/Models/User.cs

@@ -8,7 +8,7 @@ using Tgstation.Server.Api.Models.Response;
 
 namespace Tgstation.Server.Host.Models
 {
-	/// <inheritdoc />
+	/// <inheritdoc cref="Api.Models.Internal.UserModelBase" />
 	public sealed class User : Api.Models.Internal.UserModelBase, IApiTransformable<UserResponse>
 	{
 		/// <summary>

src/Tgstation.Server.Host/Models/UserGroup.cs

@@ -7,7 +7,9 @@ using Tgstation.Server.Api.Models.Response;
 
 namespace Tgstation.Server.Host.Models
 {
-	/// <inheritdoc />
+	/// <summary>
+	/// Represents a group of <see cref="User"/>s.
+	/// </summary>
 	public sealed class UserGroup : NamedEntity, IApiTransformable<UserGroupResponse>
 	{
 		/// <summary>

src/Tgstation.Server.Host/Security/AuthenticationContextFactory.cs

@@ -13,7 +13,7 @@ using Tgstation.Server.Host.Models;
 
 namespace Tgstation.Server.Host.Security
 {
-	/// <inheritdoc />
+	/// <inheritdoc cref="IAuthenticationContextFactory" />
 	sealed class AuthenticationContextFactory : IAuthenticationContextFactory, IDisposable
 	{
 		/// <inheritdoc />

src/Tgstation.Server.Host/Security/IdentityCache.cs

@@ -9,7 +9,7 @@ using Tgstation.Server.Host.Utils;
 
 namespace Tgstation.Server.Host.Security
 {
-	/// <inheritdoc />
+	/// <inheritdoc cref="IIdentityCache" />
 	sealed class IdentityCache : IIdentityCache, IDisposable
 	{
 		/// <summary>

src/Tgstation.Server.Host/Server.cs

@@ -15,7 +15,7 @@ using Tgstation.Server.Host.Core;
 
 namespace Tgstation.Server.Host
 {
-	/// <inheritdoc />
+	/// <inheritdoc cref="IServer" />
 	sealed class Server : IServer, IServerControl
 	{
 		/// <inheritdoc />

src/Tgstation.Server.Host/System/WindowsNetworkPromptReaper.cs

@@ -15,7 +15,7 @@ using Tgstation.Server.Host.Utils;
 
 namespace Tgstation.Server.Host.System
 {
-	/// <inheritdoc />
+	/// <inheritdoc cref="INetworkPromptReaper" />
 	sealed class WindowsNetworkPromptReaper : BackgroundService, INetworkPromptReaper
 	{
 		/// <summary>