Skip to content

DOC: Avoid documenting ivar default values#202

Merged
jhlegarreta merged 1 commit intoInsightSoftwareConsortium:masterfrom
jhlegarreta:AvoidDocumentingIvarDefaultValues
Jul 17, 2023
Merged

DOC: Avoid documenting ivar default values#202
jhlegarreta merged 1 commit intoInsightSoftwareConsortium:masterfrom
jhlegarreta:AvoidDocumentingIvarDefaultValues

Conversation

@jhlegarreta
Copy link
Copy Markdown
Member

Avoid documenting ivar default values since:

  • All ivar values should be initialized to some default value.
  • When default values are changed, it is easy to forget about updating the documentation and making it inconsistent with the actual value in the code.

Avoid documenting ivar default values since:
- All ivar values should be initialized to some default value.
- When default values are changed, it is easy to forget about updating
  the documentation and making it inconsistent with the actual value in
  the code.
@github-actions github-actions bot added area:Appendices Issues affecting the Appendices part language:LaTeX Changes to LaTeX code type:BookStyle Changes to book style files type:Documentation Documentation improvement or change labels Jul 16, 2023
@jhlegarreta jhlegarreta merged commit 4b6fd89 into InsightSoftwareConsortium:master Jul 17, 2023
@jhlegarreta jhlegarreta deleted the AvoidDocumentingIvarDefaultValues branch July 17, 2023 17:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:Appendices Issues affecting the Appendices part language:LaTeX Changes to LaTeX code type:BookStyle Changes to book style files type:Documentation Documentation improvement or change

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants