Skip to content

Show a opt-in warning for undocumented open / public code blocks #5974

@CodebyCR

Description

@CodebyCR

New Issue Checklist

Feature or Enhancement Proposal

Note

In the text below, code blocks means classes, structs, actors, protocols, enums, and methods.

Show a opt-in warning for undocumented open / public code blocks

This could increase the frequency of documented code that you want to share with other developers.

For example, imagine you've written a Swift package that you want to make publicly available. You want to document all the methods
that users of your package can use. These are all open and public code blocks.

Now imagine your package has more than 150 files.
It could easily happen that you forget to document some of your public or open code blocks.
But if you use an opt-in warning for this, you can step through your warnings to fix them.

Metadata

Metadata

Assignees

No one assigned

    Labels

    helpQuestions or user problems that require more explanation rather than code changes.staleIssues that did not receive responses from non-maintainers within a time frame.

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions