                             Release Notes for
                              P4 Code Review

                              Version ~:VERSION:~

Introduction

    Helix Swarm is now P4 Code Review.

    Perforce has a new look, reflecting our evolving role in DevOps workflows.
    As part of this update, Helix Swarm is now P4 Code Review,
    emphasizing its integration with Perforce P4 (formerly Helix Core) and its role within the P4 Platform.

    To learn more, see https://www.perforce.com/blog/vcs/introducing-the-p4-platform

    P4 Code Review, previously referred to as "Swarm" in release notes,
    enables team collaboration and code reviews in P4, helping you ship high-quality software faster.

    This document lists all user-visible changes to P4 Code Review for
    Release ~:VERSION:~.

    Perforce numbers releases YYYY.R/CCCCC, for example, 20~:VER:~/123456. YYYY is the
    year; R is the release of that year; CCCCC is the bug fix change level.
    Each bug fix in these release notes is marked by its change number.
    Any release includes (1) all bug fixes of all previous releases and (2)
    all bug fixes of the current release up to the bug fix change level.

    The most up to date version of these release notes can be found here:

    * http://www.perforce.com/perforce/doc.current/user/swarm_relnotes.txt

    Please send all feedback to support@perforce.com.

--------------------------------------------------------------------------

Important Platform End-of-Life Notice

    P4 Code Review no longer provides an OVA.

    P4 Code Review supports PHP 8.1 to 8.4.

    Dropped support for the below Operating Systems:
        - CentOS 7 and 8
        - Ubuntu 16 and 18
        - RHEL 7
        - Amazon Linux 2

    As of 2024.5, P4 Code Review supports PHP 8.1 and above, having discontinued support for all earlier versions.
    This shift addresses significant security issues and improves P4 Code Review's performance,
    reflecting our commitment to retiring platforms that have reached End-of-Life (EOL).
    Upon upgrading P4 Code Review, consider migrating to PHP version 8.1 and above.

--------------------------------------------------------------------------

Important Notes

    Helix Visual Client (P4V) version 2021.3 or older does not work with P4 Code Review 2022.3 or newer versions.

    v9 is the latest complete set of APIs. The v11 APIs are not yet complete,
    and might undergo refinement in the upcoming releases.

    Review Page

         You can switch back to the Classic view seamlessly using the classic view toggle.

    Task Stream Reviews

        Pre-commit reviews in a task stream are not supported.

    AI Feature
        Please read Perforce's Generative AI policy before enabling P4 Code Review's AI code analysis feature.
        See https://www.perforce.com/generative-ai-policy

--------------------------------------------------------------------------

Upgrading from earlier versions

    In the P4 Code Review 2024.3 release, Redis binary has been upgraded to version 7.2.4. As a result
    of this upgrade, the kernel and glibc requirements have automatically changed from 
    version 2.6 to 3.10. If you need to run Redis under kernel version 2.6, you can do either
    of the following:

    - Compile Redis from sources on the target host meeting the target kernel.

    - Or use your own older Redis installation.
    
    Please see the upgrade section of the documentation:
    https://help.perforce.com/helix-core/helix-swarm/swarm/~:VERSION:~/Content/Swarm/chapter-setup-upgrade.html

    In the P4 Code Review 2024.6 release, Redis binary has been upgraded to version 7.2.6.

--------------------------------------------------------------------------

Platform Notes

    P4 Code Review supports the following client web browsers at the latest stable
    browser version:

    * Apple Safari
    * Google Chrome
    * Microsoft Edge
    * Mozilla Firefox

    We recommend the use of the latest stable version of the browsers
    listed above for the best experience when using P4 Code Review.

    Other web browsers might also work, including prior, development or
    beta builds of the above web browsers, but are not officially
    supported.

    P4 Code Review requires that JavaScript and cookies are enabled in the web
    browser.

--------------------------------------------------------------------------

Supported Platforms

    Linux (x86_64)
        Ubuntu 20.04, 22.04 and 24.04
        Rocky Linux 8 and 9
        RHEL 8 and 9

    The above platforms are tested and subject to regression testing on a frequent basis.
    Errors or bugs discovered in these platforms are prioritized for correction.
    Any platform not listed above is not actively tested by Perforce.
    P4 Code Review may run on other platforms that are not actively tested.

--------------------------------------------------------------------------

Installation

    We recommend installing P4 Code Review using packages. This takes away all the
    complication of installing all the required packages and software used
    by P4 Code Review.

    Please see the installation section of the documentation:
    https://help.perforce.com/helix-core/helix-swarm/swarm/~:VERSION:~/Content/Swarm/chapter.setup.html


    Support for Ubuntu 16.04 has been dropped from release 21.1 onwards and
    support for CentOS 7 has been dropped from 2024.3.

--------------------------------------------------------------------------

Upgrading from P4 Code Review 2019.1 and earlier

    P4 Code Review 2019.2 introduced a Redis in-memory cache to improve performance and
    reduce the load on the Helix Core server. This replaces the file-based cache
    that was previously used by P4 Code Review.

    On P4 Code Review systems with a large number of users, groups, and projects, the
    initial population of this cache can take some time. If you have a large
    P4 Code Review system you should read through the Redis section of the documentation:

    https://help.perforce.com/helix-core/helix-swarm/swarm/~:VERSION:~/Content/Swarm/admin.redis.html

--------------------------------------------------------------------------

Technology Preview features:

    Features offered in Technology Preview are experimental and not
    guaranteed to always work as expected. If you have feedback and
    functionality suggestions, email techpreview@perforce.com.

--------------------------------------------------------------------------

Interoperating With Previous Releases

   P4 Code Review is tested against all supported Helix Core Server at the time of release.
   We test new releases of P4 Code Review against the versions of Helix Core that are under
   standard maintenance at the time of the release.

   https://help.perforce.com/helix-core/helix-swarm/swarm/~:VERSION:~/Content/Swarm/setup.dependencies.html#Helix_Core_Server_requirements

--------------------------------------------------------------------------

Documentation

    P4 Code Review Release ~:VERSION:~ documentation is included in the distribution
    under the "public/docs" folder. To access it locally, edit the URL to point
    to the docs directory on your local system. The documentation can be accessed from
    within P4 Code Review from the "Help" icon in the toolbar when you are logged in.

    Additionally, the documentation is available online:

    * https://help.perforce.com/helix-core/helix-swarm/swarm/~:VERSION:~

--------------------------------------------------------------------------

License

    Please see the separate "license" file, a peer to this file, or:
    https://www.perforce.com/perforce/r~:VER:~/user/swarm_license.txt
