Skip to content

Conversation

@travisrisner
Copy link

@travisrisner travisrisner commented Oct 16, 2025

User description

Update the note under requirements to indicate the difference between the Minimum and Required versions. This should help with some confusion brought up on this Joomla! issue.


PR Type

Documentation


Description

  • Clarifies distinction between Minimum and Required software versions

  • Explains Minimum versions required for upgrading from previous Joomla! versions

  • Notes Required versions may work for new installations

  • Improves documentation clarity on version compatibility requirements


Diagram Walkthrough

flowchart LR
  A["Version Requirements"] --> B["Minimum Versions"]
  A --> C["Required Versions"]
  B --> D["Guaranteed to work<br/>Required for upgrades"]
  C --> E["May work for<br/>new installs"]
Loading

File Walkthrough

Relevant files
Documentation
technical-requirements.md
Clarify minimum and required version distinctions               

docs/get-started/technical-requirements.md

  • Updated requirements note to distinguish between *Minimum* and
    *Required* software versions
  • Added clarification that *Minimum* versions are required for upgrading
    from previous Joomla! versions
  • Added note that *Required* versions may work for new installations
  • Improved documentation to reduce confusion about version compatibility
+2/-1     

@qodo-merge-pro
Copy link
Contributor

PR Compliance Guide 🔍

Below is a summary of compliance checks for this PR:

Security Compliance
🟢
No security concerns identified No security vulnerabilities detected by AI analysis. Human verification advised for critical code.
Ticket Compliance
🎫 No ticket provided
- [ ] Create ticket/issue <!-- /create_ticket --create_ticket=true -->

</details></td></tr>
Codebase Duplication Compliance
Codebase context is not defined

Follow the guide to enable codebase context checks.

Custom Compliance
No custom compliance provided

Follow the guide to enable custom compliance check.

Compliance status legend 🟢 - Fully Compliant
🟡 - Partial Compliant
🔴 - Not Compliant
⚪ - Requires Further Human Verification
🏷️ - Compliance label

@qodo-merge-pro
Copy link
Contributor

PR Code Suggestions ✨

Explore these optional code suggestions:

CategorySuggestion                                                                                                                                    Impact
General
Clarify confusing version requirement descriptions

Rephrase the description of Minimum and Required versions to remove the
confusing contradiction where a "minimum" version is guaranteed to work but a
"required" version only "may work".

docs/get-started/technical-requirements.md [10-11]

-Joomla! version. The *Minimum* versions are guaranteed to work and required for upgrading from previous Joomla! versions.
-The *Required* versions may work for new installs. Older versions may work but are not supported.
+Joomla! version. The *Minimum* versions are the lowest supported versions and are required when upgrading from a previous Joomla! release. For new installations, the *Required* versions must be used. Older versions may work but are not supported.
  • Apply / Chat
Suggestion importance[1-10]: 7

__

Why: The suggestion correctly identifies a logical contradiction in the PR's text where a *Minimum* version is "guaranteed" but a *Required* version only "may work", and proposes a clearer phrasing that improves user understanding.

Medium
  • More

@HLeithner
Copy link
Member

I have to check the the update server because this required 10.6 which might not be right, because joomla installation only required 10.4 so this is a difference which needs to be clarified.

@HLeithner
Copy link
Member

I will fix the update server, it has a wrong configuration. I keep this open till I fixed it.

@HLeithner
Copy link
Member

I fixed the update server so this should not be an issue anymore.

@HLeithner HLeithner closed this Oct 18, 2025
@brianteeman
Copy link
Contributor

Minimum and required are both absolutes - you cant have different values

@HLeithner
Copy link
Member

Please suggest a better term.

@brianteeman
Copy link
Contributor

I cant because it makes no sense to have three columns. Even the description added by this PR makes no sense

If I apply for a job which says it requires a PHD it would never also say the minimum is an MA because if I only satisfy the minimum I cannot satisfy the required

There can only be two
Recommended / Minimum
or
Recommended / Required

OR show me an example of something that has these three columns AND has different values for the absolutes of minimum and required

@HLeithner
Copy link
Member

I don't know if someone uses such table.
Fact is that we only support the required column and if you use a lower version it's your duty to solve issues. Basically it means we do not enforce the minimum version but we enforce the required version at runtime.

@brianteeman
Copy link
Contributor

Exactly - so what is the point of the minimum column other than to confuse people

@HLeithner
Copy link
Member

as always, a compromise. We don't want to increase the minimum version which is possible to use but we also don't want to support eol products. It's better someone runs a current version of joomla on a old database than running an old joomla on an old database because of this.

@brianteeman
Copy link
Contributor

then you need to find terminology that is not absolute and conflicting

would this work for you
Recommended, Supported, Minimum

@HLeithner
Copy link
Member

ok for me.

@richard67
Copy link
Member

for me, too.

@tecpromotion
Copy link
Contributor

That works for me too.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants