mirror of
https://github.com/ivuorinen/dotfiles.git
synced 2026-01-26 03:04:06 +00:00
* chore(tooling): use yarn for linting scripts * chore: fixes and tweaks * chore(ci): more permissions * chore: clean up, lint fixes * chore: clean up, lint fixes * chore: clean up, lint fixes * chore(lint): fix yamllint errors and warnings * chore(lint): lint fixes * chore(lint): lint fixes
1.4 KiB
1.4 KiB
Project guidelines
This repository contains configuration files and helper scripts for managing
a development environment.
Dotbot drives installation, and host-specific folders under hosts/ contain extra configs.
Setup
- Run
yarn installto fetch linting tools and the Bats test framework. - Re-run
yarn installwheneverpackage.jsonchanges. - Yarn is the package manager of choice; avoid
npmcommands.
Keeping the repository up to date
- Update submodules with
git submodule update --remote --merge. - Pull the latest changes and run
./install.
Linting and tests
-
Format files with:
yarn fix:prettier yarn fix:markdown -
Shell scripts must pass
shellcheck.find . -path ./node_modules -prune -o -name '*.sh' -print0 | xargs -0 shellcheck -
Ensure
.editorconfigrules pass:tools/install-ec.sh ec -
Execute tests with
yarn testwhen code changes.
Debugging lint issues
yarn lint:prettierandyarn lint:markdownshow formatting errors.- Ensure shell scripts have a shebang or
# shellcheck shell=bashdirective. - Consult
.shellcheckrcfor project specific checks.
Scripts rely on helpers in config/shared.sh so they run under Bash, Zsh and Fish by default.
Commits and PRs
- Use Semantic Commit messages:
type(scope): summary. - Keep PR titles in the same format.