paultanay opened a new issue, #1495:
URL: https://github.com/apache/answer/issues/1495

   ## Description
   The README.md Quick Start section instructs users to run:
   ```bash
   docker run -d -p 9080:80 -v answer-data:/data --name answer 
apache/answer:2.0.0
   ```
   However, the exact tag apache/answer:2.0.0 does not exist on Docker Hub. 
Only apache/answer:2.0.0-RC2 (Release Candidate) exists, which is inappropriate 
for the Quick Start guide targeting new users.
   
   Steps to Reproduce
   Visit https://github.com/apache/answer
   Follow the Quick Start command in README.md (line 26)
   Run: docker run -d -p 9080:80 -v answer-data:/data --name answer 
apache/answer:2.0.0
   Actual Result
   Unable to find image 'apache/answer:2.0.0' locally
   docker: Error response from daemon: manifest for apache/answer:2.0.0 not 
found: manifest unknown
   Expected Result
   Docker should successfully pull and run a stable version of Apache Answer.
   
   Root Cause
   Exact tag mismatch: README specifies 2.0.0 but only 2.0.0-RC2 exists on 
Docker Hub
   Latest stable release: apache/answer:1.7.1 (Dec 19, 2025)
   Latest tag: apache/answer:latest → points to 1.7.1 (stable)
   RC versions exist: 2.0.0-RC2, 2.0.0-RC1 (not suitable for Quick Start)
   Verified on Docker Hub: https://hub.docker.com/r/apache/answer/tags
   
   Impact
   Severity: High for new users
   Breaks the first command in Quick Start guide
   Poor first impression for new contributors/users
   Even if users try -RC2, they get an unstable release (not ideal for Quick 
Start)
   Proposed Fix
   Update README.md line 26 to use the stable release:
   
   ```bash
   Option 1 (Recommended):
   
   docker run -d -p 9080:80 -v answer-data:/data --name answer 
apache/answer:latest
   Benefits: Always points to latest stable release, auto-updates
   
   Option 2 (Explicit stable version):
   
   docker run -d -p 9080:80 -v answer-data:/data --name answer 
apache/answer:1.7.1
   Benefits: Explicit version for reproducibility
   
   Not recommended:
   
   docker run -d -p 9080:80 -v answer-data:/data --name answer 
apache/answer:2.0.0-RC2
   RC versions are unstable and shouldn't be in Quick Start for new users
   ```
   
   I recommend Option 1 (:latest) as it provides a better experience for new 
users.
   
   Environment
   Docker Hub tags verified:
   
   latest → 1.7.1 (stable, pushed ~2 months ago)
   1.7.1 (stable, pushed ~2 months ago)
   2.0.0-RC2 (RC, pushed 4 days ago)
   2.0.0-RC1 (RC, pushed 4 days ago)
   2.0.0 (does NOT exist - no stable release yet)
   Source: https://hub.docker.com/r/apache/answer/tags
   
   Additional Context
   This appears to be a documentation issue where the README was updated in 
anticipation of the v2.0.0 stable release, but:
   
   Only RC versions have been published so far
   The exact tag format is incorrect (missing -RC2 suffix)
   Quick Start guides should use stable releases, not RC versions
   For users wanting to test v2.0.0 features, they can explicitly use 
apache/answer:2.0.0-RC2, but this shouldn't be the default Quick Start 
recommendation.
   
   This is my first contribution to this repository. I'm happy to submit a PR 
to fix this if you'd like. It's a simple one-line change in the README.
   
   ---


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]


---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to