Skip to content

Latest commit

 

History

History
36 lines (26 loc) · 1.58 KB

File metadata and controls

36 lines (26 loc) · 1.58 KB

DarkPattern.Refactoring

A collection of C# libraries to assist with maintenance of complicated and evolving codebases.

Usage

See the refactoring example for an example.

  1. Add both DarkPatterns.Refactoring.Annotations and DarkPatterns.Refactoring.Analyzers packages to your project.

  2. Track classes, methods, etc. that are planned for removal by adding [PlannedRemoval("TICKET", "Explanation")] as needed. TICKET may be anything that does not include a space; Explanation should be a human-readable description about a recommended alternative.

  3. Warnings will be added for any usage of items planned for removal; if part of a public symbol, those also must be marked PlannedRemoval with their own explanation. If the usage is kept internal, PlannedRefactor can be added instead, which does not propagate to other uses.

  4. Add a list of tickets to a PlannedRefactoring.txt in the root of the project. The format of this file is one line per ticket, optionally with a space followed by an explanation.

    GH-1 Title of ticket
    GH-2
    GH-3 Another title