Files
computer-playbook/docs/contributing/code/languages/shell.md
T
2026-03-28 22:58:12 +01:00

21 lines
877 B
Markdown

# Shell
Use this page for shell-script-specific guidance.
## Script Layout
- You MUST store general `.sh` scripts for infinito.nexus administration under `scripts/`.
- You MUST keep shell entrypoints in `scripts/` so they stay easy to discover and reuse.
- You MUST keep role-local or component-specific shell helpers in their owning area, such as `roles/.../files/`, when they belong to a single role.
## Executable Bit
- You MUST set the executable bit on shell scripts that are meant to run directly.
- You MUST use `chmod +x` for those scripts so they can be invoked as executables.
- You MUST keep a shebang at the top of executable shell scripts.
## Notes
- `scripts/tests/deploy/local/exec/container.sh` is a direct-entry shell script example.
- For shell entrypoints that are exposed through `make`, you SHOULD prefer a thin target that delegates to the script.