adobe / adobe/helix-cli

[Documentation] CLI Troubleshooting does not reference --allowInsecure option

Open Beginner friendly
#2,742 2 comments 0 reactions 0 assignees View on GitHub
bug
Dominant language
JavaScript
Stars
68
Forks
72
Avg merge
1d 3h
Merged PRs (30d)
8

Description

**Description**
The `Troubleshooting` documentation does not provide adequate guidance needed for users to resolve the issues related to local cert issues that can occur due to Corp Admin settings or solutions such as Zscaler.

In those cases, the currently published guidance does not resolve the issue, and the only resolution for those users is often the use of the command option `--allowInsecure` which is provided on the site [aem-live](https://www.aem.live/developer/cli-reference)

It is also important to note that this CLI option is NOT referenced when the help command is run, which is problematic.

**To Reproduce**
Steps to reproduce the behavior:
1. View the troubleshooting section of the README.md
2. Run the command `aem help`

**Expected behavior**
Effective troubleshooting guidance would be provided and consistent documentation for the CLI solution would be published.

**Screenshots**
If applicable, add screenshots to help explain your problem.

Image

**Version:**
run: `$ aem --version`
`16.19.11`

**Additional context**
Add any other context about the problem here.

Contributor guide

Open the contributing guide

Research direction

Start with the Troubleshooting section of README.md and run `aem help` to compare the published guidance with the available CLI options. Update the troubleshooting and CLI help documentation so both reference `--allowInsecure` and explain its relevance to local certificate issues.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript
Domain
cli, documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
64/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.