Skip to content
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

docs: add sorbet documentation #8386

Merged
merged 1 commit into from
Aug 27, 2020

Conversation

vidusheeamoli
Copy link
Contributor

  • Have you followed the guidelines in our Contributing document?
  • Have you checked to ensure there aren't other open Pull Requests for the same change?
  • Have you added an explanation of what your changes do and why you'd like us to include them?
  • Have you written new tests for your changes? Here's an example.
  • Have you successfully run brew style with your changes locally?
  • Have you successfully run brew tests with your changes locally?

Documentation for Sorbet.

@vidusheeamoli
Copy link
Contributor Author

Going to add another section which deals with how to resolve type errors reported by Sorbet ASAP.
cc - @issyl0 @mistydemeo

Copy link
Member

@mistydemeo mistydemeo left a comment

Choose a reason for hiding this comment

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

This is a great start!

I'd like to see a bit more of an introduction here. Having some links to the Sorbet documentation and its "how to get started" documentation would be great. We want to make sure that Homebrew developers who are familiar with the Homebrew codebase, but not with Sorbet, have a place to get some guidance on where to go from here.

Copy link
Member

@MikeMcQuaid MikeMcQuaid left a comment

Choose a reason for hiding this comment

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

Looks good to me so far! Can you also link this in the README under "Contributors"? Thanks!

natively. RBI files for all gems are auto-generated using
[Tapioca](https://github.com/Shopify/tapioca#tapioca). We can also create a RBI
file to help Sorbet understand dynamic definitions.
For eg: Sorbet assumes that `Kernel` is not necessarily included in our modules
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
For eg: Sorbet assumes that `Kernel` is not necessarily included in our modules
For example: Sorbet assumes that `Kernel` is not necessarily included in our modules

Copy link
Member

@MikeMcQuaid MikeMcQuaid left a comment

Choose a reason for hiding this comment

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

Some nits otherwise: looks great to me, nice work!

docs/Typechecking.md Outdated Show resolved Hide resolved
docs/Typechecking.md Outdated Show resolved Hide resolved
docs/Typechecking.md Outdated Show resolved Hide resolved
docs/Typechecking.md Outdated Show resolved Hide resolved
docs/Typechecking.md Outdated Show resolved Hide resolved
(cherry picked from commit 022571489a0f94ed54a0908167b553592cfe3277)
@MikeMcQuaid MikeMcQuaid merged commit 995eb3a into Homebrew:master Aug 27, 2020
@MikeMcQuaid
Copy link
Member

Let's merge for now and can always address additional comments in a follow-up PR. Nice work again @vidusheeamoli!

@vidusheeamoli vidusheeamoli deleted the documentation branch September 2, 2020 07:32
@BrewTestBot BrewTestBot added the outdated PR was locked due to age label Dec 14, 2020
@Homebrew Homebrew locked as resolved and limited conversation to collaborators Dec 14, 2020
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
outdated PR was locked due to age
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

4 participants