diff --git a/.gitattributes b/.gitattributes new file mode 100644 index 0000000..67888c8 --- /dev/null +++ b/.gitattributes @@ -0,0 +1,24 @@ +# GitHub linguist + default text handling +# This file corrects repository language detection and normalizes line endings +# for text files tracked in git. + +# Normalize line endings for text files +* text=auto eol=lf + +# Common non-code / vendored paths that should not count toward language stats +# (uncomment as needed per repository) +# *.min.js linguist-vendored +# node_modules/ linguist-vendored +# vendor/ linguist-vendored +# dist/ linguist-vendored +# build/ linguist-vendored + +# Binary assets +*.png binary +*.jpg binary +*.jpeg binary +*.gif binary +*.webp binary +*.svg text eol=lf +*.ico binary +*.pdf binary diff --git a/CODEOWNERS b/CODEOWNERS new file mode 100644 index 0000000..e16d05b --- /dev/null +++ b/CODEOWNERS @@ -0,0 +1,16 @@ + +# Default owners for OneByJorah repositories +# https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners +* @OneByJorah + +# CI, issue templates, and community files need an owner review +/.github/ @OneByJorah +/PULL_REQUEST_TEMPLATE.md @OneByJorah + +# Documentation +*.md @OneByJorah + +# Configuration and secrets-like files (review before merge) +*.env* @OneByJorah +*.yaml @OneByJorah +*.yml @OneByJorah diff --git a/SUPPORT.md b/SUPPORT.md new file mode 100644 index 0000000..640ad84 --- /dev/null +++ b/SUPPORT.md @@ -0,0 +1,33 @@ +--- +hide_title: true +--- +# Support + +## How to get help + +- **GitHub Issues:** [Open an issue](https://github.com/OneByJorah/VoiceCortex/issues) for bugs and feature requests. +- **Email:** [info@jorahone.com](mailto:info@jorahone.com) for private or time-sensitive matters. +- **Discussions:** Use the [discussions board](https://github.com/OneByJorah/VoiceCortex/discussions) for usage questions and ideas. + +## What to include in a bug report + +- Repository and version/branch. +- Operating system and runtime version (Python/Node/PowerShell as applicable). +- Steps to reproduce. +- Expected vs actual behavior. +- Relevant logs or screenshots. + +## Self-hosting support + +These are self-hosted infrastructure tools. Support assumes you have basic familiarity with Docker, reverse proxies, and the relevant service protocols. + +- Run services behind a reverse proxy (Caddy/Nginx) with TLS. +- Keep Tailscale/WireGuard as the preferred exposure model. +- Rotate secrets and API keys regularly. +- Bind services to localhost unless a reverse proxy handles TLS. + +## Community + +- [JorahOne, LLC](https://jorahone.com) +- [github.com/OneByJorah](https://github.com/OneByJorah) +