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

Break out a blog/ section of the docsite #4108

Closed
lihaoyi opened this issue Dec 11, 2024 · 1 comment · Fixed by #4151
Closed

Break out a blog/ section of the docsite #4108

lihaoyi opened this issue Dec 11, 2024 · 1 comment · Fixed by #4151
Milestone

Comments

@lihaoyi
Copy link
Member

lihaoyi commented Dec 11, 2024

As discussed on the PR #3990, the page How fast does Java compile? does not really belong in documentation, and is more like a blog post. We didn't have any blog/ section before and I wanted it on mill-build.org for SEO purposes, so I just put it somewhere, but we should break out a dedicated blog/ section of the docsite for it and other articles. We can write other articles for SEO as well

Some article ideas:

  • What is needed for a monorepo build tool?
  • Deep dive into Mill's caching and invalidation strategy
  • Deep dive into Mill's parallelism strategy
  • Optimizing JVM code with JProfiler
@lefou
Copy link
Member

lefou commented Dec 11, 2024

Antora has a notion of modules which can be versioned. We could split up the current "ROOT" module. "blog" could be one part, the actual versioned documentation could be another. And we could keep only some basic overview stuff in ROOT, like installation, license and changelog, since those things don't really depend on the version but rather reflect the page deployment time.

lihaoyi added a commit that referenced this issue Dec 17, 2024
Fixes #4108

For now we move the `compile-java.adoc` post over there with an
appropriate forwarder, and added another post `Why Use a Monorepo Build
Tool?`. We can write more posts going forward
@lefou lefou added this to the 0.12.4 milestone Dec 17, 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 a pull request may close this issue.

2 participants