Skip to content

Documentation fixes#6524

Merged
valadas merged 15 commits intodnnsoftware:developfrom
bdukes:documentation-fixes
Apr 30, 2025
Merged

Documentation fixes#6524
valadas merged 15 commits intodnnsoftware:developfrom
bdukes:documentation-fixes

Conversation

@bdukes
Copy link
Copy Markdown
Contributor

@bdukes bdukes commented Apr 29, 2025

Summary

This PR resolves a number of StyleCop documentation issues and begins treating those warnings as errors.

@bdukes bdukes added this to the 10.0.2 milestone Apr 29, 2025
@bdukes bdukes force-pushed the documentation-fixes branch from 2f5e957 to ced700f Compare April 30, 2025 17:00
@bdukes bdukes force-pushed the documentation-fixes branch from ced700f to c965561 Compare April 30, 2025 17:22
bdukes added 15 commits April 30, 2025 12:24
Parameter documentation must match the parameters
A C# method, constructor, delegate or indexer element is missing documentation for one or more of its parameters.
The <summary> tag within an element's Xml header documentation contains the default text generated by Visual Studio during the creation of the element.
The <summary> tag within the documentation header for a C# code element is empty.
The <summary> or <content> tag within the documentation header for a C# code element is missing or empty.
The Xml header documentation for a C# element is missing a <summary> tag.

Platform/DotNetNuke.Web/UI/WebControls/Internal/DnnFormToggleButtonItem.cs
Platform/DotNetNuke.Web/UI/WebControls/Internal/DnnGridTemplateColumn.cs
An item within a C# enumeration is missing an Xml documentation header.
A C# partial element is missing a documentation header.
A <param> tag within a C# element's documentation header is empty.
A C# method, constructor, delegate or indexer element is missing documentation
for one or more of its parameters.

Dnn.AdminExperience/Dnn.PersonaBar.Extensions/Services/SecurityController.cs

Platform/DotNetNuke.Web.Mvc/Framework/ActionFilters/AuthorizeAttributeBase.cs
Platform/Providers/FolderProviders/DotNetNuke.Providers.FolderProviders.csproj
Platform/Website/DesktopModules/Admin/EditExtension/EditExtension.ascx.cs
Platform/Website/DesktopModules/Admin/Security/ProfileDefinitions.ascx.cs
Dnn.AdminExperience/Dnn.PersonaBar.Extensions/Components/Pages/ICloneModuleExecutionContext.cs
Dnn.AdminExperience/Dnn.PersonaBar.Extensions/Components/Security/Utility.cs
Dnn.AdminExperience/Dnn.PersonaBar.Extensions/Dnn.PersonaBar.Extensions.csproj
Dnn.AdminExperience/Dnn.PersonaBar.Extensions/Services/ExtensionsController.cs
Dnn.AdminExperience/Dnn.PersonaBar.Extensions/Services/SecurityController.cs
Dnn.AdminExperience/Dnn.PersonaBar.Extensions/Services/UsersController.cs
Dnn.AdminExperience/Dnn.PersonaBar.Extensions/Services/VocabulariesController.cs
Dnn.AdminExperience/EditBar/Dnn.EditBar.UI/Services/LocalizationController.cs
Dnn.AdminExperience/Library/Dnn.PersonaBar.Library/Controllers/IPersonaBarUserSettingsController.cs
Dnn.AdminExperience/Library/Dnn.PersonaBar.Library/Dnn.PersonaBar.Library.csproj
Dnn.AdminExperience/Library/Dnn.PersonaBar.Library/Repository/IPersonaBarExtensionRepository.cs
Dnn.AdminExperience/Library/Dnn.PersonaBar.UI/Services/LocalizationController.cs
Dnn.AdminExperience/Library/Dnn.PersonaBar.UI/Services/TabsController.cs
Dnn.AdminExperience/Library/Dnn.PersonaBar.UI/Services/UserSettingsController.cs
A generic C# element is missing documentation for one or more of its generic type parameters.
A C# element is missing documentation for its return value.
A C# code file is missing a standard file header.
The <summary> or <content> tag within the documentation header for a C# code element is empty.
A C# partial element is missing a documentation header.

Platform/DotNetNuke.Web/InternalServices/ContentWorkflowServiceController.cs
Platform/Modules/MemberDirectory/DotNetNuke.Modules.MemberDirectory.csproj
Platform/Modules/MemberDirectory/ViewModels/MemberDirectorySettingsModel.cs
Platform/Website/DesktopModules/Admin/SearchResults/ResultsSettings.ascx.cs
Platform/Website/DesktopModules/Admin/SearchResults/SearchResults.ascx.cs
Platform/Website/DesktopModules/Admin/UrlManagement/UrlProviderSettings.ascx.cs
Platform/Website/DesktopModules/AuthenticationServices/DNN/Settings.ascx.cs
Dnn.AdminExperience/Dnn.PersonaBar.Extensions/Components/Pages/PagesController.cs
Dnn.AdminExperience/Dnn.PersonaBar.Extensions/Components/Prompt/IModulesController.cs
Dnn.AdminExperience/Dnn.PersonaBar.Extensions/Components/Prompt/Models/Command.cs
Dnn.AdminExperience/Dnn.PersonaBar.Extensions/Components/Prompt/Models/CommandHelp.cs
Dnn.AdminExperience/Dnn.PersonaBar.Extensions/Components/Prompt/Models/CommandOption.cs
Dnn.AdminExperience/Dnn.PersonaBar.Extensions/Components/Prompt/ModulesController.cs
Dnn.AdminExperience/Dnn.PersonaBar.Extensions/Components/Prompt/Repositories/CommandRepository.cs
Dnn.AdminExperience/Dnn.PersonaBar.Extensions/Components/Prompt/Repositories/ICommandRepository.cs
Dnn.AdminExperience/Dnn.PersonaBar.Extensions/Components/SqlConsole/SqlConsoleQuery.cs
Dnn.AdminExperience/Dnn.PersonaBar.Extensions/Components/Users/Prompt/Utilities.cs
Dnn.AdminExperience/Dnn.PersonaBar.Extensions/Dnn.PersonaBar.Extensions.csproj
Dnn.AdminExperience/Library/Dnn.PersonaBar.Library/Dnn.PersonaBar.Library.csproj
Dnn.AdminExperience/Library/Dnn.PersonaBar.Library/Helper/PortalHelper.cs
Dnn.AdminExperience/Library/Dnn.PersonaBar.Library/Prompt/Attributes/ConsoleCommandAttribute.cs
Dnn.AdminExperience/Library/Dnn.PersonaBar.Library/Prompt/ConsoleCommandBase.cs
Dnn.AdminExperience/Library/Dnn.PersonaBar.Library/Prompt/IConsoleCommand.cs
Dnn.AdminExperience/Library/Dnn.PersonaBar.Library/Prompt/Models/ConsoleErrorResultModel.cs
Dnn.AdminExperience/Library/Dnn.PersonaBar.Library/Prompt/Models/PagingInfo.cs
Dnn.AdminExperience/Library/Dnn.PersonaBar.UI/admin/personaBar/UserControls/PersonaBarContainer.ascx.cs
@bdukes bdukes force-pushed the documentation-fixes branch from c965561 to e0d568d Compare April 30, 2025 17:24
@valadas valadas merged commit 8f2d2a3 into dnnsoftware:develop Apr 30, 2025
3 checks passed
@bdukes bdukes deleted the documentation-fixes branch April 30, 2025 18:09
@valadas valadas modified the milestones: 10.0.2, 10.1.0 Jul 30, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants