-
Notifications
You must be signed in to change notification settings - Fork 1.4k
Improve the in-source docs of the PackageDescription API for better readability. #2175
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
Improve the in-source docs of the PackageDescription API for better readability. #2175
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Very minor comments but otherwise this looks great! Thanks for all the work on this :)
/// is recommended to not declare the type of library explicitly to let the | ||
/// Swift Package Manager choose between static or dynamic linking depending | ||
/// on the consumer of the package. | ||
/// A library’s product can either be statically or dynamically linked. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
the quote seems weird, shouldn't it be '
?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
We often use curly quotes, I can change all of them to straight quotes if you prefer that?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I am fine with whichever one is preferred but we should make it consistent throughout the docs.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I decided to use the regular quotes for consistency with other docs.
a9d31ac
to
f6292e6
Compare
@swift-ci smoke test |
This PR improves the in-source docs of the
PackageDescription
API for better readability and clarity.