diff --git a/website/content/en/community/mailinglists.adoc b/website/content/en/community/mailinglists.adoc index 5c801ef5b5..9864a7621c 100644 --- a/website/content/en/community/mailinglists.adoc +++ b/website/content/en/community/mailinglists.adoc @@ -1,40 +1,40 @@ --- title: "Mailing Lists" sidenav: community --- include::shared/en/mailing-lists.adoc[] include::shared/en/urls.adoc[] = Mailing Lists Mailing lists are the primary communication channel for the FreeBSD community, and cover many topic areas: - https://lists.freebsd.org/[] - link:{mailing-list-faq}[frequently asked questions]. == Archives Browse: - https://lists.freebsd.org/archives/[] Search: - https://lists.freebsd.org/search[] -Achives prior to May 2021 are in https://lists.freebsd.org/pipermail/[a separate area]. +Archives prior to May 2021 are in https://lists.freebsd.org/pipermail/[a separate area]. == Non-English Lists * *Brazilian Portuguese* -- freebsd-subscribe@fug.com.br or http://www.fug.com.br/[WWW]. * *Czech* -- users-l-request@FreeBSD.cz or http://www.cz.FreeBSD.org/listserv/listinfo/users-l/[WWW]. * *German* -- http://www.freebsd.de/mailinglists.html[Administration] or http://www.freebsd.de[Search]. * *Hungarian* -- bsd@lista.bsd.hu, http://lista.bsd.hu/[Administration] or http://datacast.hu/pipermail/bsd/[Search]. * *Italian* -- mailman-owner@gufi.org or http://liste.gufi.org/[WWW]. * *Japanese* -- freebsd-users-jp@FreeBSD.org or https://lists.freebsd.org/subscription/freebsd-users-jp[WWW]. * *Norwegian* -- bsd@nobug.no or http://www.nobug.no/[WWW]. * *Russian* -- https://groups.google.com/forum/#!forum/uafug[UAFUG]. * *Swedish* -- bus@stacken.kth.se or https://lists.stacken.kth.se/mailman/listinfo/bus[WWW]. If you create another list, please link:../../mailto/[let us know]. diff --git a/website/content/en/portmgr/charter.adoc b/website/content/en/portmgr/charter.adoc index cea4eb8df5..40a71dd68f 100644 --- a/website/content/en/portmgr/charter.adoc +++ b/website/content/en/portmgr/charter.adoc @@ -1,28 +1,28 @@ --- title: "Charter for the Ports Management Team" sidenav: about --- = Charter for the Ports Management Team The FreeBSD Ports Collection is a product intended first and foremost for the end-users of FreeBSD. The Ports Management Team (portmgr) is the group charged with overseeing its development. Its members are appointed by the FreeBSD Core Team (core). The primary responsibility of the Team is to ensure that the FreeBSD Ports Developer community provides a ports collection that is functional, stable, up-to-date and full-featured. Its secondary responsibility is to coordinate among the committers and developers who work on it. The Ports Management Team has the following specific responsibilities: * Assure the integrity of the Ports Collection by managing commits to the `ports` portion of the FreeBSD repository. This includes maintaining certain key files directly; running test builds of proposed large changes; and acting as arbiter over other commits. * Maintain the automated http://pkg.FreeBSD.org[package building cluster], and make the resulting packages available for download by FreeBSD users. -* Work with the FreeBSD Security team to ensure that security problems are indentified and handled in a timely fashion. +* Work with the FreeBSD Security team to ensure that security problems are identified and handled in a timely fashion. * Work with FreeBSD Ports and Documentation Committers to keep the relevant documentation up to date. * To the extent possible with a volunteer project, ensure that the legal rights of authors whose works are installed in the Ports Collection are respected. * Act as arbiter of first resort for disputes between FreeBSD community members such as maintainers and committers. * Manage commit access to the ports tree. All new committer approvals must be sent to admins@, and CC'd to core@; they must be PGP-signed. * Establish guidelines and policies governing the rights and responsibilities of Ports Committers and maintainers. * Help prioritize future directions for the overall Ports Collection. In addition to its specific responsibilities, the Ports Management Team may take whatever actions it believes prudent to manage the ports collection responsibly. Please see link:../policies/[Ports Team Policies] for a complete list of the current policies which have been adopted to help implement these goals. This charter is under the control of the FreeBSD Core Team. It is valid until such time as it is modified or revoked by the Core Team; any changes to this charter must be approved by the Core Team. diff --git a/website/content/en/portmgr/policies.adoc b/website/content/en/portmgr/policies.adoc index 5ca030302c..7848fd0a85 100644 --- a/website/content/en/portmgr/policies.adoc +++ b/website/content/en/portmgr/policies.adoc @@ -1,91 +1,92 @@ --- title: "Policies of the Ports Management Team" sidenav: about --- include::shared/en/urls.adoc[] = Policies of the Ports Management Team In accordance with its link:../charter/[Charter], the Ports Management Team has adopted certain policies to try to meet each of its goals. link:../policies_eol/[EOL Policies of Ports and Ports Intrastructure] == Assure The Integrity Of The Ports Collection To help assure the integrity of the Ports Collection, portmgr acts as sole committer for certain files that are integral to it, such as `bsd.port.mk`. Since the ports tree is not branched (unlike some of the other BSD projects), any fatal error in these files will be quickly picked up by the many users who run automated updates of their ports. portmgr also runs periodic builds of proposed large changes to the Ports Collection on a dedicated area of the automated https://pkg-status.freebsd.org[ports building cluster]. These are termed experimental builds (often referred to as "exp-runs"). Examples of changes that should be tested here before committing include: * changes to `bsd.port.mk` * changes to packages with many dependencies, including X11 servers, GNOME, KDE, autotools, and so forth * changes that change the "accepted best practice" for ports Makefiles, such as definitions or usage of common make variables (or `Makevar`s). (e.g., consolidation of various implementations of USE_*, WITH_*, and so forth) * large changes to the repository (such as when an existing port category is divided up) Any large-scale failures that might be caused by any of the above need to be caught first before a large number of user installations are affected. At other times, especially during the preparations for a new release, there are link:../policies_committing/[other restrictions on when commits are allowed]. portmgr reserves the right to act as final arbiter of other commits in certain unusual cases, such as: commits that in their opinion destabilize the Ports Collection; violate the Principle Of Least Astonishment for FreeBSD's users; or in cases of inter-committer disputes that cannot be solved among the committers themselves. == Maintain The Automated Ports Building Cluster portmgr maintains a set of machines that automatically build packages on combinations of FreeBSD source tree versus CPU architecture (in our terminology, `build environments` or `buildenv`s). Where license distribution permits, the resulting packages are regularly uploaded to the main FTP mirror as the "new latest package" so that they are available for download by FreeBSD users. Port build failures are reported to the responsible maintainers and/or committers for the appropriate corrective action. In some cases ports may become broken by changes to the FreeBSD base system (src/ tree). In such a case, the Ports Management Team expects the responsible Source Committer to develop fixes to the affected ports, in consultation with the relevant port maintainers. == Work With The FreeBSD Security Team == Work with FreeBSD Ports and Documentation Committers portmgr will attempt to help keep the link:{porters-handbook}[FreeBSD Porter's Handbook] up to date with what it believes to be the "best practices" for individual ports. (The intent is not just to lay down 'rules' but to say 'here is why something that we advocate as The Right Thing in the ports Makefiles is done.' In particular, there are a number of "edge cases" that `bsd.*.mk` has some very convoluted code to handle -- such as ensuring that ports can be installed from CD-ROM, over NFS, and so forth -- and failing to understand these issues can lead to maintainers using shortcuts that will not work in these edge cases.) portmgr is not the sole owner of the Porter's Handbook, as it is actually in the `doc/` tree. We welcome PR submitters and `doc` committers to work on it to add documentation that helps to clarify existing practice. However, we would like to request, as a courtesy, the right to review any changes that would seem to change existing practice. In addition, there has been recent discussion about creating a "Rights And Responsibilities of FreeBSD Ports Maintainers and Committers" document. portmgr supports this effort and looks forward to being able to review any drafts. portmgr also is responsible for certain other documentation such as the ports-specific portions of the link:{committers-guide}#ports[Committer's Guide] and the link:{contributing}#ports-contributing[Contributing to FreeBSD Guide]. == Respect The Legal Rights Of Authors Whose Works Are Installed Via The Ports Collection To the extent possible with a volunteer project, portmgr will work to ensure that the legal rights of authors whose works are installed via the Ports Collection are respected. This includes making sure that the appropriate entries are made to `ports/LEGAL` and to the `makevars` that control package building and thus automated distribution of binaries. In rare cases this may also require removing a port and all distfiles and binaries if the original author demands it. portmgr asks our volunteer committers to carefully consider authors' licensing restrictions when committing new ports, since it is infeasible for the members of portmgr to do so themselves due to the huge number of ports. == Act As Arbiter Of First Resort For Disputes Between FreeBSD Community Members Such As Maintainers And Committers -portmgr encourages members of the FreeBSD community to work together in accordance with the principles set out in the Committer's Guide. In case of disputes, it reserves the right to abitrate, subject to review by the Core Team. +portmgr encourages members of the FreeBSD community to work together in accordance with the principles set out in the Committer's Guide. In case of disputes, it reserves the right to arbitrate, subject to review by the Core +Team. == Manage Commit Access To The Ports Tree The FreeBSD Core Team has delegated the responsibility to manage commit access to the `ports/` tree to portmgr. Core reviews granting and revocation of commit bits and has final authority over all the entire FreeBSD repositories. New Ports Committers are proposed by an existing Ports Committer who wishes to act as a mentor. The proposals should include a brief summary of the history of contributions made by the proposed new committer such as number of PRs submitted, number of ports currently maintained, and existing commit bits in other trees, if any. In its votes the team will consider that history as well as any other relevant factors. The results of the votes are made available to the FreeBSD developer community. In accordance with practice elsewhere in the project, inactive Ports Committers are link:../policies_contributors/#commit_privileges[periodically contacted] to enquire about their status and interest in continuing to work with the ports tree. Committers who do not respond to such email, or who respond in the negative, have their commit bits reclaimed for safekeeping. Currently, this period is one year. In unusual cases it may become necessary to remove Ports Committers for other reasons. This will only be done after serious deliberation, and is subject to review by Core. == Establish Guidelines And Policies Governing The Rights And Responsibilities Of Ports Committers And Maintainers portmgr has the responsibility to establish guidelines and policies governing the rights and responsibilities of Ports Committers and maintainers, such as expected standards of maintainership, conditions under which maintainers may be overridden or removed, and other policies. To ensure that ports Problem Reports are handled in a timely manner, portmgr has established a guideline about how long a PR assigned to a committer may remain open before being eligible for being committed by another committer via a link:../policies_contributors/#pr_timeout["maintainer timeout"]. This time period applies to such things as updates that do not require a regression run; for other updates, please contact portmgr directly. The time period does not count ports freezes and generally recognized holidays. In addition, to ensure that ports are maintained in a timely fashion, portmgr has established a guideline about how long a port maintainer may be inactive before link:../policies_contributors/#maintainer_reset[forfeiting maintainership]. "inactive" is not interpreted strictly, but is intended to encompass such things as unresolved open PRs, commits made by others via maintainer timeouts, and unresolved build problems. The intent of these policies is not to assign punishment or blame, but to reflect the fact that the software installed by the Ports Collection undergoes rapid development that is outside FreeBSD's control. Part of the responsibility that a ports maintainer accepts is to try to keep a port working and as up-to-date as feasible. It is unfair to our users to let unfixed problems languish and stale versions remain. However, we also recognize that all of our maintainers and committers are volunteers just as we are, and that as with any volunteer project, it is easy to overcommit, or lose interest in a particular port. Maintainers and committers who feel overcommitted or have lost interest in any particular port should feel free to ask for new volunteers and/or reassignment of the port back to the general pool. Not only will this help keep the Ports Collection current, but hopefully will help prevent volunteer burnout. == Help Prioritize Future Directions For The Overall Ports Collection portmgr recognizes that the development and evolution of the Ports Collection is primarily driven by the work of community members. However, due to the unbranched nature of the Ports Collection, it is sometimes necessary to coordinate, or even choose among, any proposed changes. To some extent this involves choosing which patches are adopted for testing on the build cluster, but it also involves such issues as working to build consensus over architectural decisions, creating lists of "interesting projects", and so forth. diff --git a/website/content/en/releng/_index.adoc b/website/content/en/releng/_index.adoc index a398740e94..c57fafd213 100644 --- a/website/content/en/releng/_index.adoc +++ b/website/content/en/releng/_index.adoc @@ -1,147 +1,147 @@ --- title: "Release Engineering Information" sidenav: developers --- include::shared/authors.adoc[] include::shared/en/urls.adoc[] = Release Engineering Information This page contains documentation about the FreeBSD release engineering process. * <> * <> * link:../releng/charter/[Charter for the Release Engineering Team] * <> * <> * <> //// General information about committing to -STABLE. //// [[schedule]] == Upcoming Release Schedule Note: Release dates are approximate and may be subject to schedule slippage. As of 2023-11-24, the next release has not yet been announced. //// [.tblbasic] [cols=",,",options="header",] |=== |Date |Event |Information |October 2023 |FreeBSD 14.0 |link:../releases/14.0R/schedule/[Target Schedule] |=== //// [[freeze]] == Code-Freeze Status This table lists the code freeze status for major branches of the `src/` repository of the FreeBSD Git repositories. Commits to any branch listed as "frozen" must first be reviewed and approved by the relevant contact party. The status of other repositories such as `ports/` and `doc/` is also provided below. [.tblbasic] [cols="1,1,2,4",options="header",] |=== |Branch |Status |Contact |Notes |`main` |Open |committers |Active development branch for 15.0-CURRENT. |`stable/14` |Open |committers |Development branch for FreeBSD 14-STABLE. |`releng/14.0` |Frozen |re@FreeBSD.org |FreeBSD 14.0 supported errata fix branch. |`stable/13` |Open |committers |Development branch for FreeBSD 13-STABLE. |`releng/13.2` |Frozen |security-officer@FreeBSD.org |FreeBSD 13.2 supported errata fix branch. |`releng/13.1` |Frozen |security-officer@FreeBSD.org |FreeBSD 13.1 errata fix branch (not officially supported). |`releng/13.0` |Frozen |security-officer@FreeBSD.org |FreeBSD 13.0 errata fix branch (not officially supported). |`stable/12` |Open |committers |Development branch for FreeBSD 12-STABLE. |`releng/12.4`|Frozen|security-officer@FreeBSD.org|FreeBSD 12.4 supported errata fix branch. |`releng/12.3` |Frozen |security-officer@FreeBSD.org |FreeBSD 12.3 errata fix branch (not officially supported). |`releng/12.2` |Frozen |security-officer@FreeBSD.org |FreeBSD 12.2 errata fix branch (not officially supported). |`releng/12.1` |Frozen |security-officer@FreeBSD.org |FreeBSD 12.1 errata fix branch (not officially supported). |`releng/12.0` |Frozen |security-officer@FreeBSD.org |FreeBSD 12.0 errata fix branch (not officially supported). |`stable/11` |Open |committers |Maintenance branch for FreeBSD 11-STABLE (not officially supported). |`releng/11.4` |Frozen |security-officer@FreeBSD.org |FreeBSD 11.4 errata fix branch (not officially supported). |`releng/11.3` |Frozen |security-officer@FreeBSD.org |FreeBSD 11.3 errata fix branch (not officially supported). |`releng/11.2` |Frozen |security-officer@FreeBSD.org |FreeBSD 11.2 errata fix branch (not officially supported). |`releng/11.1` |Frozen |security-officer@FreeBSD.org |FreeBSD 11.1 errata fix branch (not officially supported). |`releng/11.0` |Frozen |security-officer@FreeBSD.org |FreeBSD 11.0 errata fix branch (not officially supported). |`stable/10` |Open |committers |Maintenance branch for 10-STABLE (not officially supported). |`releng/10.4` |Frozen |security-officer@FreeBSD.org |FreeBSD 10.4 errata fix branch (not officially supported). -|`releng/10.3` |Frozen |security-officer@FreeBSD.org |FreeBSD 10.3 errata fix branch (not officialy supported). +|`releng/10.3` |Frozen |security-officer@FreeBSD.org |FreeBSD 10.3 errata fix branch (not officially supported). |`releng/10.2` |Frozen |security-officer@FreeBSD.org |FreeBSD 10.2 errata fix branch (not officially supported). |`releng/10.1` |Frozen |security-officer@FreeBSD.org |FreeBSD 10.1 errata fix branch (not officially supported). |`releng/10.0` |Frozen |security-officer@FreeBSD.org |FreeBSD 10.0 errata fix branch (not officially supported). |`stable/9` |Open |committers |Maintenance branch for FreeBSD 9-STABLE (not officially supported). |`releng/9.3` |Frozen |security-officer@FreeBSD.org |FreeBSD 9.3 errata fix branch (not officially supported). |`releng/9.2` |Frozen |security-officer@FreeBSD.org |FreeBSD 9.2 errata fix branch (not officially supported). |`releng/9.1` |Frozen |security-officer@FreeBSD.org |FreeBSD 9.1 errata fix branch (not officially supported). |`releng/9.0` |Frozen |security-officer@FreeBSD.org |FreeBSD 9.0 errata fix branch (not officially supported). |`stable/8` |Open |committers |Maintenance branch for 8-STABLE (not officially supported). |`releng/8.4` |Frozen |security-officer@FreeBSD.org |FreeBSD 8.4 errata fix branch (not officially supported). |`releng/8.3` |Frozen |security-officer@FreeBSD.org |FreeBSD 8.3 errata fix branch (not officially supported). |`releng/8.2` |Frozen |security-officer@FreeBSD.org |FreeBSD 8.2 errata fix branch (not officially supported). |`releng/8.1` |Frozen |security-officer@FreeBSD.org |FreeBSD 8.1 errata fix branch (not officially supported). |`releng/8.0` |Frozen |security-officer@FreeBSD.org |FreeBSD 8.0 errata fix branch (not officially supported). |`stable/7` |Open |committers |Maintenance branch for 7-STABLE (not officially supported). |`releng/7.4` |Frozen |security-officer@FreeBSD.org |FreeBSD 7.4 errata fix branch (not officially supported). |`releng/7.3` |Frozen |security-officer@FreeBSD.org |FreeBSD 7.3 errata fix branch (not officially supported). |`releng/7.2` |Frozen |security-officer@FreeBSD.org |FreeBSD 7.2 errata fix branch (not officially supported). |`releng/7.1` |Frozen |security-officer@FreeBSD.org |FreeBSD 7.1 errata fix branch (not officially supported). |`releng/7.0` |Frozen |security-officer@FreeBSD.org |FreeBSD 7.0 errata fix branch (not officially supported). |`stable/6` |Open |committers |Maintenance branch for 6-STABLE (not officially supported). |`releng/6.4` |Frozen |security-officer@FreeBSD.org |FreeBSD 6.4 errata fix branch (not officially supported). |`releng/6.3` |Frozen |security-officer@FreeBSD.org |FreeBSD 6.3 errata fix branch (not officially supported). |`releng/6.2` |Frozen |security-officer@FreeBSD.org |FreeBSD 6.2 errata fix branch (not officially supported). |`releng/6.1` |Frozen |security-officer@FreeBSD.org |FreeBSD 6.1 errata fix branch (not officially supported). |`releng/6.0` |Frozen |security-officer@FreeBSD.org |FreeBSD 6.0 errata fix branch (not officially supported). |`stable/5` |Open |committers |Maintenance branch for 5-STABLE (not officially supported). |`releng/5.5` |Frozen |security-officer@FreeBSD.org |FreeBSD 5.5 errata fix branch (not officially supported). |`releng/5.4` |Frozen |security-officer@FreeBSD.org |FreeBSD 5.4 errata fix branch (not officially supported). |`releng/5.3` |Frozen |security-officer@FreeBSD.org |FreeBSD 5.3 errata fix branch (not officially supported). |`releng/5.2` |Frozen |security-officer@FreeBSD.org |FreeBSD 5.2 / 5.2.1 security fix branch (not officially supported). |`releng/5.1` |Frozen |security-officer@FreeBSD.org |FreeBSD 5.1 security fix branch (not officially supported). |`releng/5.0` |Frozen |security-officer@FreeBSD.org |FreeBSD 5.0 security fix branch (not officially supported). |`stable/4` |Open |committers |Maintenance branch for 4-STABLE (not officially supported). |`releng/4.11` |Frozen |security-officer@FreeBSD.org |FreeBSD 4.11 errata fix branch (not officially supported). |`releng/4.10` |Frozen |security-officer@FreeBSD.org |FreeBSD 4.10 security fix branch (not officially supported). |`releng/4.9` |Frozen |security-officer@FreeBSD.org |FreeBSD 4.9 security fix branch (not officially supported). |`releng/4.8` |Frozen |security-officer@FreeBSD.org |FreeBSD 4.8 security fix branch (not officially supported). |`releng/4.7` |Frozen |security-officer@FreeBSD.org |FreeBSD 4.7 security fix branch (not officially supported). |`releng/4.6` |Frozen |security-officer@FreeBSD.org |FreeBSD 4.6 security fix branch (not officially supported). |`releng/4.5` |Frozen |security-officer@FreeBSD.org |FreeBSD 4.5 security fix branch (not officially supported). |`releng/4.4` |Frozen |security-officer@FreeBSD.org |FreeBSD 4.4 security fix branch (not officially supported). |`releng/4.3` |Frozen |security-officer@FreeBSD.org |FreeBSD 4.3 security fix branch (not officially supported). |`stable/3` |Open |committers |Maintenance branch for 3-STABLE (not officially supported). |`stable/2.2` |Open |committers |Maintenance branch for 2.2-STABLE (not officially supported). |*Repository* |*Status* |*Contact* |*Notes* |`ports/` |Open |portmgr@FreeBSD.org |FreeBSD Ports Collection. |`doc/` |Open |freebsd-doc@FreeBSD.org |ASCIIDoc-based documentation set. |=== [[docs]] == Release Engineering Documentation * link:{freebsd-releng}[FreeBSD Release Engineering] + This document details the approach used by the FreeBSD release engineering team to make production-quality releases of the FreeBSD Operating System. It describes the tools available for those interested in producing customized FreeBSD releases for corporate rollouts or commercial productization. [[team]] == Release Engineering Team The primary release engineering team is responsible for approving link:{handbook}#mfc-glossary[MFC] requests during code freezes, setting release schedules, and all of the other responsibilities laid out in our link:../releng/charter/[charter]. *Primary RE Team (re@FreeBSD.org)* : {re-members} form the primary release engineering decision-making group. The builders release engineering team is responsible for building and packaging FreeBSD releases on the various supported platforms. *Builders REs (re-builders@FreeBSD.org)* : {re-builders} The third party packages in the Ports Collection are managed by the pkgmgr@ team. Among many other responsibilities, the package managers keep the ports cluster running smoothly to produce binary packages. *Package Builders (pkgmgr@FreeBSD.org)* : {pkgmgr-members} [[old]] == Old Releases The FreeBSD Project does not maintain a complete archive of old release ISO images, but many of them are available at ftp://ftp-archive.FreeBSD.org/pub/FreeBSD-Archive/old-releases/. Older releases that are no longer present on any FTP mirror might still be available from CD-ROM vendors.