Files
voculinux/SUPPORT.md
T
Jatin K MalikandGitHub f48bdda525 docs: improve project documentation for a clearer public surface (#634)
* docs: polish project documentation for a clearer public surface

Rewrite the README and supporting docs for a more professional first
impression: less emoji and badge noise, install-first structure, and a
real documentation index. Add a Contributor Covenant, tighten SECURITY
and GitHub templates, and make distro/update guides read as product docs
instead of internal status notes.

* docs: split install guide and add changelog plus support pages

Break INSTALL.md into a short primary guide, manual/PyPI package lists,
and troubleshooting. Add root CHANGELOG.md and SUPPORT.md, wire them
into the docs index and README, and drop the outdated screenshot lag note
now that v0.15 assets are on main.

* docs: humanize PR copy and remove em dashes

Strip em/en dashes from the documentation rewritten in this PR, fix
mid-sentence colon fallout from that pass, and smooth a few stiff
phrases so the public docs read more natural.

* docs: list Faster Whisper after rebase onto main

Installer and CLI already accept faster_whisper. Document it next to
the other engines, drop the outdated screenshot lag note, and keep the
on-device wording honest for local vs remote.
2026-09-07 22:51:14 -07:00

1.7 KiB

Support

Where to get help with Vocalinux.

Documentation

Topic Doc
Install docs/INSTALL.md
Manual / PyPI install docs/INSTALL_MANUAL.md
Troubleshooting docs/TROUBLESHOOTING.md
Day-to-day use docs/USER_GUIDE.md
Upgrading docs/UPDATE.md
Distros and sessions docs/DISTRO_COMPATIBILITY.md
Remote transcription API docs/HTTP_REMOTE.md
Full index docs/README.md
Website vocalinux.com

Community

Channel Use for
Discord Fastest place to talk with maintainers
GitHub Discussions Questions, setup help, ideas
Bug report Something is broken
Feature request New capability proposals

When filing a bug, include OS/distro, vocalinux --version, install method, display server (X11/Wayland), engine, and a vocalinux --debug snippet.

Security

Do not post vulnerability details in public issues. Follow SECURITY.md.

Contributing

Code and docs: CONTRIBUTING.md. Community standards: CODE_OF_CONDUCT.md.

Maintainer contact

General product questions are best on Discussions or Discord so others can find the answer. Security only: see SECURITY.md.