Overhaul FAQ: fix stale content, add missing troubleshooting entries - #133
Merged
Merged
Conversation
- Drop redundant "AlmaLinux 10 " title prefix. - Fix MariaDB version section: state the currently pinned version (12.3) instead of a stale "initially 11.4, upgrade to 11.8" framing that never described real installer behavior and will drift again. - Fix the Composer self-update sample output: it previously implied self-update changes the PHP version; both before/after now show the same PHP version, since self-update never touches it. - Add new entries: a dev-only security framing (plaintext MariaDB password, root-login phpMyAdmin, unconfigured firewalld) with how to open a port if ever needed; a systemd troubleshooting entry matching the note added to installation.md; port-already-in-use troubleshooting (Docker Desktop/IIS/Skype holding port 80); a git credential-helper entry covering the Windows Git Credential Manager and gh/glab alternatives to plaintext credential.helper=store; and an environment-teardown entry distinct from the destructive wsl --unregister. - Update the table of contents to match.
arhimede
approved these changes
Sep 24, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
(12.3, per
wsl/roles/mariadb/templates/MariaDB.repo.j2) instead of astale "initially 11.4, upgrade to 11.8" framing that never described real
installer behavior. Resolves Feature/os detector #6.
change between before/after (
self-updatenever touches PHP).Resolves Updated WSL readme file. #7.
.conf-suffixed filenamesnow agree with the corrected
create-virtualhost.md(PR C). Resolves test ansible recipe on Windows 11 #1(cross-file consistency).
root-login phpMyAdmin, unconfigured firewalld) with how to open a port
if ever needed. Resolves npm install veraious versions #16.
installation.md(PR B). Resolves WSL: Create Ansible playbook for AlmaLinux 8 #8.holding port 80). Resolves AlmaLinux9: Unable to install MariaDB #14.
Manager and
gh/glabalternatives to plaintextcredential.helper=store. Resolves add to readme.md usefull info #13.wsl --unregister. Resolves Issue #16: Install Node.js and allow switching to different versions. #17.