dotnet add package StyleCop.Analyzers

{
  "$schema": "https://raw.githubusercontent.com/DotNetAnalyzers/StyleCopAnalyzers/master/StyleCop.Analyzers/StyleCop.Analyzers/Settings/stylecop.schema.json",
  "settings": {
    "documentationRules": {
      "companyName": "Your Company",
      "copyrightText": "Copyright (c) {companyName}. All rights reserved."
    },
    "orderingRules": {
      "usingDirectivesPlacement": "outsideNamespace"
    }
  }
}

<ItemGroup>
  <AdditionalFiles Include="stylecop.json" />
</ItemGroup>

{
  "settings": {
    "documentationRules": {
      "documentExposedElements": false
    }
  }
}

// <copyright file="SampleController.cs" company="Your Company">
// Copyright (c) Your Company. All rights reserved.
// </copyright>

namespace YourProject.Controllers
{
    using System;
    using Microsoft.AspNetCore.Mvc;

    /// <summary>
    /// Sample controller for demonstration.
    /// </summary>
    [Route("api/[controller]")]
    [ApiController]
    public class SampleController : ControllerBase
    {
        /// <summary>
        /// Gets a sample response.
        /// </summary>
        /// <returns>A sample string response.</returns>
        [HttpGet]
        public ActionResult<string> Get()
        {
            return "Hello, StyleCop!";
        }

        /// <summary>
        /// Posts a sample message.
        /// </summary>
        /// <param name="message">The message to process.</param>
        /// <returns>The processed message.</returns>
        [HttpPost]
        public ActionResult<string> Post([FromBody] string message)
        {
            if (string.IsNullOrWhiteSpace(message))
            {
                throw new ArgumentException("Message cannot be empty", nameof(message));
            }

            return $"Processed: {message}";
        }
    }
}

steps:
- task: DotNetCoreCLI@2
  displayName: 'Run StyleCop Analysis'
  inputs:
    command: build
    arguments: '--no-restore /p:TreatWarningsAsErrors=true'