Skip to content

Add documentation about each module's purpose and move some files between modules #1517

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 1 commit into from
Jun 27, 2024

Conversation

ahoppen
Copy link
Member

@ahoppen ahoppen commented Jun 25, 2024

The purpose of the different modules wasn’t clearly defined, which lead to inconsistent responsibilities between the different modules. Define each module’s purpose and move a few files between modules to satisfy these definitions.

There are a few more larger changes that will need to be made for a fully consistent module structure. These are FIXMEs in the new Modules.md document and I’ll address them in follow-up PRs.

…ween modules

The purpose of the different modules wasn’t clearly defined, which lead to inconsistent responsibilities between the different modules. Define each module’s purpose and move a few files between modules to satisfy these definitions.

There are a few more larger changes that will need to be made for a fully consistent module structure. These are FIXMEs in the new Modules.md document and I’ll address them in follow-up PRs.
@ahoppen ahoppen requested a review from bnbarham June 25, 2024 14:48
@ahoppen
Copy link
Member Author

ahoppen commented Jun 25, 2024

@swift-ci Please test

@ahoppen ahoppen requested a review from hamishknight June 25, 2024 14:50
@@ -0,0 +1,121 @@
# Modules

The SourceKit-LSP package contains the following non-testing modules.
Copy link
Contributor

Choose a reason for hiding this comment

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

What's the "non-testing" mean here?

Copy link
Member Author

Choose a reason for hiding this comment

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

Technically the testTargets are also modules. But I didn’t include them here because they aren’t really relevant for the modules structure.

Copy link
Contributor

Choose a reason for hiding this comment

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

Ah I see 👍 Not sure why this didn't make me think of testTarget.

@ahoppen ahoppen merged commit 9c6a91d into swiftlang:main Jun 27, 2024
3 checks passed
@ahoppen ahoppen deleted the document-module-purpose branch June 27, 2024 03:09
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