Skip to content

docs: improve documentation#12

Open
dahlinomine wants to merge 1 commit intoamaar-mc:mainfrom
dahlinomine:docs/improve-readme-1774589248
Open

docs: improve documentation#12
dahlinomine wants to merge 1 commit intoamaar-mc:mainfrom
dahlinomine:docs/improve-readme-1774589248

Conversation

@dahlinomine
Copy link
Copy Markdown

Summary

This PR improves the README documentation for this project.

Changes: Improve documentation


This contribution was made as part of an open-source documentation improvement initiative. All changes are meant to be helpful additions to the project.

Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR updates the project’s README to simplify the “Quick Start” and replace the existing detailed usage/contribution guidance with a shorter set of instructions.

Changes:

  • Simplifies the “Initialize” steps in Quick Start.
  • Replaces the existing Contributing section with a generic 5-step contribution checklist.
  • Updates the License section to reference the LICENSE file.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

```bash
cd your-project
wit init
wit start
Copy link

Copilot AI Mar 27, 2026

Choose a reason for hiding this comment

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

wit start is documented in the Quick Start, but the CLI doesn't appear to provide a start subcommand (commands are init, status, declare, lock, release, watch, etc.). Also, wit init already starts the daemon via ensureDaemon(), so this extra step is likely incorrect/confusing. Update the README to remove wit start (or document the correct command if one exists).

Suggested change
wit start

Copilot uses AI. Check for mistakes.
Comment on lines 74 to 75

```bash
Copy link

Copilot AI Mar 27, 2026

Choose a reason for hiding this comment

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

The init instructions no longer include changing into the target repository (previously cd your-project). Since wit init operates on the current working directory, the README should explicitly tell users to run it from the project root to avoid initializing in the wrong directory.

Suggested change
```bash
From the root of the repository you want to coordinate (for example, after `cd your-project`), run:
```bash
cd your-project # ensure you're in the project root

Copilot uses AI. Check for mistakes.
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