Skip to content

docs: user documentation draft#32

Closed
branchseer wants to merge 17 commits intomainfrom
11-13-doc_draft
Closed

docs: user documentation draft#32
branchseer wants to merge 17 commits intomainfrom
11-13-doc_draft

Conversation

@branchseer
Copy link
Member

@branchseer branchseer commented Nov 15, 2025

Add comprehensive documentation for Vite Task

This PR adds detailed documentation for Vite Task, covering:

  1. Getting Started - Basic usage examples showing how to run tasks
  2. Defining Tasks - How to configure tasks in package.json and vite-task.json
  3. Task Orchestration - Composing tasks with dependencies and multi-step execution
  4. Configuring Cache - Detailed options for controlling cache behavior

branchseer and others added 17 commits November 13, 2025 17:36
- Fix typos: "ouput" → "output", "regognizes" → "recognizes", "beyoud" → "beyond", "descison" → "decision", "cauious" → "cautious"
- Simplify wording: remove unnecessary words like "flexibility and", "currently", "practically"
- Improve grammar: fix subject-verb agreement ("Cache are" → "Caching is")
- Clarify explanations: rework awkward phrases for better readability
- Maintain technical accuracy while making text more concise

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
- Move CLI usage patterns from separate file into Getting Started
- Remove standalone "CLI Options" file (too minimal, only 3 lines)
- Reorder: put "Configuring Cache" before "Task Orchestration"
  - Cache concepts are referenced in orchestration
  - Logical progression: define tasks → cache them → orchestrate them
- Update all cross-references to reflect new numbering

New structure:
1. Getting Started (now includes CLI usage)
2. Defining Tasks
3. Task Orchestration (was 4)
4. Configuring Cache (was 5)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
- Change "script" to "command" in Task Orchestration example for consistency
- Fix "inputs" to "outputs" in Configuring Cache example to match the comment about saving dist files

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
Copy link
Member Author

This stack of pull requests is managed by Graphite. Learn more about stacking.

@branchseer branchseer changed the title doc: draft docs: user documentation draft Nov 15, 2025
@branchseer branchseer marked this pull request as ready for review November 15, 2025 13:41
@@ -0,0 +1,82 @@
# Getting Started

Vite is designed to work out of the box with zero configuration. Simply run `vite run <script>` to execute any script defined in your `package.json` file.

Choose a reason for hiding this comment

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

We need some intro to explain what it is, what problem it solves, and what it is similar to.

```

The first time you run `vite run lint`, Vite Task will execute it just like `npm run lint`:

Choose a reason for hiding this comment

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

I'd add a info box:

What's the difference between vite run lint and vite lint?

  • vite run lint is invoking the Vite task runner. It runs the lint script defined under scripts in package.json.
  • vite lint is invoking Vite's lint command that performs the actual linting.

Copy link
Collaborator

Choose a reason for hiding this comment

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

Built-in commands like cargo lint or cargo fmt are written without run, so I don’t think they’re a good example for vite run.

More abstractly, how about using an example like vite run hello with "hello": "echo hello" instead?

@ubugeeei
Copy link
Collaborator

ubugeeei commented Feb 3, 2026

Like oxlint and oxfmt, it might be necessary to provide a JSON Schema and build the documentation around that assumption.

@branchseer branchseer closed this Mar 13, 2026
@branchseer branchseer deleted the 11-13-doc_draft branch March 13, 2026 06:19
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