Brohammad / Brohammad/VoxForge

Add make help as the default Makefile target

Open Beginner friendly
#36 0 comments 0 reactions 0 assignees View on GitHub
enhancement good first issue
Dominant language
Python
Stars
4
Forks
1
Avg merge
5d 13m
Merged PRs (30d)
10

Description

## Task

`Makefile` has 15+ phony targets and no index. `make` with no args is not useful for newcomers.

## Scope

- `.DEFAULT_GOAL := help`
- `help` prints target + one-line description for existing targets (`test`, `test-browser`, `lint`, `prove-real-voice`, etc.)
- Mention `make help` in CONTRIBUTING and ONBOARDING

## Acceptance criteria

- [ ] `make` and `make help` print the list
- [ ] Existing target recipes unchanged

Contributor guide

Open the contributing guide

Research direction

Start with the Makefile and inspect its existing phony targets, including test, test-browser, lint, and prove-real-voice. Add the default help behavior and document make help in CONTRIBUTING and ONBOARDING, while leaving existing recipes unchanged. Run make and make help to confirm both print the target list.

Written by the indexing model from the issue text.

Assessment

Domain
build-system
Issue type
Feature
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Active
Clarity
Clearly specified
Newbie friendliness
84/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.