Merge branch 'dev' into V6

2026-08-23 04:57:17 +01:00 · 2023-09-03 19:33:01 +00:00
parent 58d8424f10 d8d46abd04
commit 178fad75af
32 changed files with 36 additions and 32 deletions
@@ -11,7 +11,7 @@ using Tgstation.Server.Api.Models.Response;

 namespace Tgstation.Server.Client
 {
-	/// <inheritdoc />
+	/// <inheritdoc cref="IAdministrationClient" />
 	sealed class AdministrationClient : PaginatedClient, IAdministrationClient
 	{
 		/// <summary>
@@ -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>
@@ -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>
@@ -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>
@@ -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>
@@ -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>
@@ -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>
@@ -11,7 +11,7 @@ using Tgstation.Server.Client.Components;

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

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

 namespace Tgstation.Server.Client
 {
-	/// <inheritdoc />
+	/// <inheritdoc cref="IUsersClient" />
 	sealed class UsersClient : PaginatedClient, IUsersClient
 	{
 		/// <summary>
@@ -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 />
@@ -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
@@ -27,7 +27,7 @@ using Tgstation.Server.Host.Utils;

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

 namespace Tgstation.Server.Host.Jobs
 {
-	/// <inheritdoc />
+	/// <inheritdoc cref="IJobService" />
 	sealed class JobService : IJobService, IDisposable
 	{
 		/// <summary>
@@ -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>
@@ -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>
@@ -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>
@@ -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>
@@ -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
@@ -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>
@@ -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>
@@ -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>
@@ -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>
@@ -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>
@@ -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>
@@ -13,7 +13,7 @@ using Tgstation.Server.Host.Models;

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

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

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

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