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

Overhaul introductory section of docsite #3293

Merged
merged 15 commits into from
Jul 26, 2024
Merged

Conversation

lihaoyi
Copy link
Member

@lihaoyi lihaoyi commented Jul 25, 2024

Flesh out the intro to include answers to all the frequently asked questions, as determined by the recent discussion on reddit r/java and r/programming

Generally tried to make it more information dense and structured, covering the main points and elaborations in bullets, and with more detailed sections comparing against Maven, Gradle, and SBT. I tried to limit the descriptions to things that would be of most direct interest to Gradle/Maven users with zero knowledge of Mill or Scala, which means more empirical stuff (e.g. performance, IDE support, ease of customization) v.s. philosophical stuff (e.g. intuitive abstractions, pure FP, etc.)

I renamed all the Scala_ and Java_ pages to follow a consistent naming convention, and added forwarder aliases as necessary

@lihaoyi lihaoyi requested review from lefou and lolgab July 25, 2024 11:58
without "_spooky action at a distance_", and the exact meaning of any config statement is
a single "_jump-to-definition_" away in your IDE.


Copy link
Member Author

Choose a reason for hiding this comment

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

@lefou @lolgab do you guys use Gradle? I'm trying to come up with a third bullet point to put here, but not sure what it should be. What are the things a gradle user would find most interesting about Mill?

Copy link
Member

Choose a reason for hiding this comment

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

I don't. Beside the missing mental model in Gradle, since the build configuration isn't a one to one mapping to some internal structure, but rather some distant incoherent interpreter.

What else I suffered in Gradle when I tried it many many years ago (before 2010, don't know if that changed since), is the magical use of files in the directory tree (upwards and downwards). That's one of the reasons I often argue for explicit includes and the single source of truth concept in Mill.

without "_spooky action at a distance_", and the exact meaning of any config statement is
a single "_jump-to-definition_" away in your IDE.


Copy link
Member

Choose a reason for hiding this comment

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

I don't. Beside the missing mental model in Gradle, since the build configuration isn't a one to one mapping to some internal structure, but rather some distant incoherent interpreter.

What else I suffered in Gradle when I tried it many many years ago (before 2010, don't know if that changed since), is the magical use of files in the directory tree (upwards and downwards). That's one of the reasons I often argue for explicit includes and the single source of truth concept in Mill.

docs/modules/ROOT/partials/Intro_to_Mill_Header.adoc Outdated Show resolved Hide resolved
docs/modules/ROOT/partials/Intro_to_Mill_Header.adoc Outdated Show resolved Hide resolved
docs/modules/ROOT/pages/Scala_Intro_to_Mill.adoc Outdated Show resolved Hide resolved
docs/modules/ROOT/pages/Scala_Intro_to_Mill.adoc Outdated Show resolved Hide resolved
@lihaoyi lihaoyi merged commit b02af6f into com-lihaoyi:main Jul 26, 2024
36 of 39 checks passed
@lefou lefou added this to the 0.11.11 milestone Jul 26, 2024
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