Closed keithlogan94 closed 1 year ago
@AndrewBabbitt97 the linting is forcing me to write comments on code that we already know we are going to remove from the application because it's Kubernetes CRDs or related.
I don't want to write comments on code we know is going to be deleted.
@AndrewBabbitt97 can you make it so missing xml comments do not cause failed checks?
Seems to mostly be CRD resources for commenting.... We aren't getting rid of the fields even if we transpose it into a database no? If so then the comments would still be of value as they will just be transposed into database models
We will not be disabling inline documentation requirements for public APIs. If you don't want to do documentation comments on something it should be marked as internal
or private
as it isn't exposed publicly.
The plan is to align similarly to many other linters, code comments are generally a requirement no matter the language.
I just don't want to write code we are planning to delete.
The most efficient way would be to remove all that code now, and refactor it to database.
Working app
Summary of the changes
{Summary} (Less than 80 characters)
Description
{Detail}
Fixes #{issue number}