Skip to content

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

Merged

Conversation

ElektrojungeAtWork
Copy link
Contributor

This PR improves the in-source docs of the PackageDescription API for better readability and clarity.

Copy link
Contributor

@aciidgh aciidgh left a 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.
Copy link
Contributor

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 '?

Copy link
Contributor Author

@ElektrojungeAtWork ElektrojungeAtWork Jun 19, 2019

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?

Copy link
Contributor

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.

Copy link
Contributor Author

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.

@aciidgh aciidgh force-pushed the Enhancement/Update-Source-Docs branch from a9d31ac to f6292e6 Compare June 24, 2019 19:24
@aciidgh
Copy link
Contributor

aciidgh commented Jun 24, 2019

@swift-ci smoke test

@aciidgh aciidgh merged commit a50667e into swiftlang:master Jun 25, 2019
@ElektrojungeAtWork ElektrojungeAtWork deleted the Enhancement/Update-Source-Docs branch May 7, 2020 05:59
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.

2 participants