Skip to content

Commit

Permalink
docs: Reword to task runner.
Browse files Browse the repository at this point in the history
  • Loading branch information
milesj committed Feb 21, 2023
1 parent 81b0ebd commit 8b782ec
Show file tree
Hide file tree
Showing 12 changed files with 20 additions and 20 deletions.
2 changes: 1 addition & 1 deletion packages/cli/README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# @moonrepo/cli

The official CLI for [moon](https://moonrepo.dev), a build system and repo management tool for the
The official CLI for [moon](https://moonrepo.dev), a task runner and repo management tool for the
web ecosystem, written in Rust! Supports JavaScript, TypeScript, Bash, and Batch.

- [Documentation](https://moonrepo.dev/docs)
Expand Down
10 changes: 5 additions & 5 deletions website/docs/comparison.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ and the ecosystem.
## Unique features

Although moon is still in its infancy, we provide an array of powerful features that other frontend
centric build systems do not, such as...
centric task runners do not, such as...

- **[Integrated toolchain](./concepts/toolchain)** - moon manages its own version of programming
languages and dependency managers behind the scenes, so that every task is executed with the
Expand All @@ -53,9 +53,9 @@ sections for more information, or these wonderful articles provided by the commu

### Turborepo

At a high-level, Turborepo and moon seem very similar as they both claim to be build systems. They
At a high-level, Turborepo and moon seem very similar as they both claim to be task runners. They
both support incremental builds, content/smart hashing, local and remote caching<sup>1</sup>,
parallel execution, and everything else you'd expect from a build system. But that's where the
parallel execution, and everything else you'd expect from a task runner. But that's where the
similarities stop, because in the end, Turborepo is nothing more than a `package.json` scripts
orchestrator with a caching layer. While moon also supports this, it
[aims to be far more](#unique-features) with a heavy focus on the developer experience.
Expand Down Expand Up @@ -169,7 +169,7 @@ Outside of this, there are no publicly available plans for Turborepo's future.
right={
<>

moon plans to be so much more than a build system, with one such facet being a repository management
moon plans to be so much more than a task runner, with one such facet being a repository management
tool. This includes code ownership, dependency management and auditing, repository linting, in-repo
secrets, and anything else we deem viable.

Expand All @@ -191,7 +191,7 @@ We also plan to support additional languages as first-class citizens within our
### Lerna

Lerna was a fantastic tool that helped the JavaScript ecosystem grow and excelled at package
versioning and publishing (and still does), but it offered a very rudimentary build system. While
versioning and publishing (and still does), but it offered a very rudimentary task runner. While
Lerna was able to run scripts in parallel, it wasn't the most efficient, as it did not support
caching, hashing, or performant scheduling.

Expand Down
2 changes: 1 addition & 1 deletion website/docs/concepts/task.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ through [`.moon/tasks.yml`][tasks].

## Inheritance

Unlike other build systems that require the same tasks to be repeatedly defined for _every_ project,
Unlike other task runners that require the same tasks to be repeatedly defined for _every_ project,
moon uses an inheritance model where tasks can be defined once at the workspace-level, and are then
inherited by _many or all_ projects.

Expand Down
8 changes: 4 additions & 4 deletions website/docs/create-task.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -8,9 +8,9 @@ import LangPartials from '@site/src/components/LangPartials';

<HeaderLabel text="6 min" />

The primary focus of moon is a build system, and for it to operate in any capacity, it requires
tasks to run. In moon, a task is a binary or system command that is ran as a child process within
the context of a project (is the current working directory). Tasks are defined per project with
The primary focus of moon is a task runner, and for it to operate in any capacity, it requires tasks
to run. In moon, a task is a binary or system command that is ran as a child process within the
context of a project (is the current working directory). Tasks are defined per project with
[`moon.yml`](./config/project), or inherited by many projects with
[`.moon/tasks.yml`](./config/tasks), but can also be inferred from a language's ecosystem
([we'll talk about this later](./migrate-to-moon)).
Expand Down Expand Up @@ -67,7 +67,7 @@ import ArgsRust from './__partials__/create-task/rust/args.mdx';

With this, the task can be ran from the command line with
[`moon run <project>:build`](./commands/run)! This is tasks in its most simplest form, but continue
reading on how to take full advantage of our build system.
reading on how to take full advantage of our task runner.

### Inputs

Expand Down
2 changes: 1 addition & 1 deletion website/docs/guides/javascript/node-handbook.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ This guide is a living document and will continue to be updated over time!

## moon setup

For this part of the handbook, we'll be focusing on [moon](/moon), our build system. To start,
For this part of the handbook, we'll be focusing on [moon](/moon), our task runner. To start,
languages in moon act like plugins, where their functionality and support _is not_ enabled unless
explicitly configured. We follow this approach to avoid unnecessary overhead.

Expand Down
2 changes: 1 addition & 1 deletion website/docs/guides/root-project.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ import VersionLabel from '@site/src/components/Docs/VersionLabel';

<VersionLabel header version="0.9" />

Coming from other repositories or build systems, you may be familiar with tasks available at the
Coming from other repositories or task runner, you may be familiar with tasks available at the
repository root, in which one-off, organization, maintenance, or process oriented tasks can be ran.
moon supports this through a concept known as a root-level project.

Expand Down
2 changes: 1 addition & 1 deletion website/docs/setup-toolchain.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ skip to the next article, [creating a project](./create-project).

Before we continue, we should briefly talk about Node.js package managers. To start, moon does not
replace a package manager, nor does it apply any "magic" for them to work differently. Instead, moon
builds upon a package manager to provide a robust build system, assumes a standard `node_modules`
builds upon a package manager to provide a robust task runner, assumes a standard `node_modules`
layout and module resolution algorithm, and supports any of the following 3 package managers.

- [npm](https://docs.npmjs.com/)
Expand Down
2 changes: 1 addition & 1 deletion website/docs/setup-workspace.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ by the `.moon` folder — this is known as the workspace root. The workspace is
- Integrating with a version control system.
- Defining configuration that applies to its entire tree.
- Housing [projects](./concepts/project) to build a project graph.
- Running tasks and the build system.
- Running tasks.

## Initializing the repository

Expand Down
2 changes: 1 addition & 1 deletion website/docusaurus.config.js
Original file line number Diff line number Diff line change
Expand Up @@ -92,7 +92,7 @@ const config = {
items: [
{
to: '/moon',
html: '<strong class="block mr-2">moon</strong><div class="opacity-60">Build system for managing codebases</div>',
html: '<strong class="block mr-2">moon</strong><div class="opacity-60">Tool for managing codebases</div>',
},
{
to: '/moonbase',
Expand Down
2 changes: 1 addition & 1 deletion website/src/components/Products/Moon/Hero.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ export default function Hero() {
</h1>

<p className="mt-1 mb-0 text-base text-white sm:text-lg sm:max-w-xl sm:mx-auto md:text-xl md:mx-0 md:pr-4">
A build system and repository management tool for the web ecosystem, written in Rust.
A task runner and repository management tool for the web ecosystem, written in Rust.
</p>

<p className="mt-1 text-white opacity-50 text-sm md:text-base md:pr-4">
Expand Down
4 changes: 2 additions & 2 deletions website/src/pages/index.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -36,13 +36,13 @@ export default function Home() {
<main className="bg-gradient-to-b from-slate-600 via-blurple-600 to-white">
<ProductSection
color="text-blurple-400"
suptitle="A build system for a solid foundation"
suptitle="A system for a solid foundation"
title="Supercharge your codebase"
logo={<img src="/brand/moon/icon.svg" height={75} className="block" />}
description={
<>
For repositories with multiple projects, any number of languages, and team members
constantly pushing changes, our build system{' '}
constantly pushing changes, our task runner{' '}
<Link href="/moon" size="lg">
moon
</Link>{' '}
Expand Down
2 changes: 1 addition & 1 deletion website/src/pages/moon.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -183,7 +183,7 @@ const additionalFeatures: Feature[] = [
export default function ProductMoon() {
return (
<Layout
title="moon - A build system and repository management tool for the web ecosystem, written in Rust"
title="moon - A task runner and repository management tool for the web ecosystem, written in Rust"
description="Reduces build times and repository maintenance costs through high-quality developer tooling."
>
<Hero />
Expand Down

0 comments on commit 8b782ec

Please sign in to comment.