Skip to content

Update Comments.md #40

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Jul 18, 2022
Merged

Update Comments.md #40

merged 3 commits into from
Jul 18, 2022

Conversation

nodes11
Copy link
Contributor

@nodes11 nodes11 commented Jun 21, 2022

  • Add convention and rationale for the different types of single line and multi line comments in Swift.

  • Add new examples for each type of comment.

* Add convention and rationale for the different types of single line and multi line comments in Swift.

* Add new examples for each type of comment.
@nodes11 nodes11 merged commit 9d2e474 into microsoft:gh-pages Jul 18, 2022
@@ -124,3 +124,61 @@ func loadLastCheckpoint() -> GameState? {
return loadedState
}
```

## Convention: Single line and multi line comment types

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Something I started reviewing and apparently didn't publish: Should we explicitly mention that for non-public properties we recommend using /// as well? Or do we have no recommendation? In which case that would also be good to explicitly state?

This documentation is awesome, but the main remaining question that usually comes up is "what should I do for comments in code which don't directly translate to public API documentation?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants