Compare commits
55 commits
| Author | SHA1 | Date | |
|---|---|---|---|
| 63cbfe6ac5 | |||
| 30aed9be20 | |||
| a9646e3638 | |||
| f4b3c6f0bd | |||
| 8d8f8a421e | |||
|
5240880e50 | ||
| 42d9f4429f | |||
| f8354971f4 | |||
| 42c5492b46 | |||
| 8ae087460c | |||
| c3a73e03a3 | |||
| ac124580cc | |||
| c3abe589ce | |||
| 10ecd8fcfd | |||
| 17153ac992 | |||
| 19ec2c1042 | |||
| 8e211f404d | |||
| 82dbfc933c | |||
| fb620d9a76 | |||
| 6955fdb8d1 | |||
| f4451ef915 | |||
| bd218282ec | |||
| db7089f6e7 | |||
| 42ad4a8089 | |||
| 00206313ec | |||
| 7f522500cd | |||
| 3d8228b52e | |||
| 0ba7125459 | |||
| 869c6ef021 | |||
| 7a7b7add96 | |||
| 7014233758 | |||
| ffc387d406 | |||
| 69ce33384b | |||
| 0b8241f181 | |||
| ff1acc2f3f | |||
68b545677a
|
|||
| c0210a674c | |||
| 1782d1593d | |||
|
21bd346cd9 | ||
| 4ecda66198 | |||
| 2310942f0f | |||
| 9e0984c7dc | |||
| 1fd0e97f26 | |||
| 6038940fa5 | |||
| b47593831e | |||
| a5f83f83e5 | |||
| 7aa1fa3a68 | |||
| 2cd9464302 | |||
| a21a3f57b3 | |||
| 6913b7d622 | |||
|
c3d84370ea
|
|||
|
4d5f8c3a3a
|
|||
|
3c47f3fa44
|
|||
| 48237b8b68 | |||
| 555c03d223 |
49 changed files with 319 additions and 627 deletions
33
.forgejo/issue_template/change.md
Normal file
33
.forgejo/issue_template/change.md
Normal file
|
|
@ -0,0 +1,33 @@
|
|||
---
|
||||
name: Change template
|
||||
about: Use this template to open an issue for a Fedora Change
|
||||
title: "Change: "
|
||||
---
|
||||
|
||||
This issue tracks the release note for the following Fedora Change:
|
||||
|
||||
!!!!LINK TO WIKI HERE!!!!
|
||||
|
||||
**If you own this change**, please add additional information here that we should communicate to Fedora users. Specifically, please consider:
|
||||
|
||||
* New features available because of this change - pick those that are important to end users
|
||||
* Considerations for users of previous releases of Fedora (upgrade issues, format changes, etc.)
|
||||
* Links to any upstream Release Notes
|
||||
* If this helps Fedora be a superior environment for our target audiences, please explain how so that we can emphasize this.
|
||||
|
||||
Your notes to us do not need to be formally written - we will edit them and add details if needed. This is a way for you to ensure that we know what is critical about your change.
|
||||
|
||||
**If you want to write this release note**, then:
|
||||
|
||||
* Assign this issue to yourself
|
||||
* Check the wiki page linked above, find out what the change is about
|
||||
* Determine whether the change actually made it into the release or not[0]
|
||||
* Write a draft release note using that information against the correct branch here, in Gitlab. (or see below)
|
||||
* Get in touch with the contact person/people listed on the wiki page, either through IRC/Matrix or e-mail or just by @-mentioning them in a comment here, and ask them to check your draft for technical accuracy
|
||||
* Submit your Release Note as a PR to this repository.
|
||||
|
||||
Once you're done with the above, make sure to either commit the relnote to an appropriate section of the Release Notes, or, if you're not familiar with Git, AsciiDoc, or whatever else, just add it to this issue as a comment and let the team[1] know that you're done with this one and you'd like the note included. Be sure to do this at least one day before the final release (see current schedule[2]). Also make sure to do this even for relnotes that haven't been checked by the change owner.
|
||||
|
||||
[0] You can do that by asking the change owner listed on the wiki page; alternatively you can infer it by checking the tracker bug (linked in Wiki) in Bugzilla and looking at its status; see bug comments for details. Ask someone on Matrix if you're not sure.
|
||||
[1] On Matrix in the Fedora Documentation channel - see https://docs.fedoraproject.org/en-US/project/communications/.
|
||||
[2] Schedules are all here: https://fedorapeople.org/groups/schedule/ - make sure to pick the correct release.
|
||||
137
README.md
137
README.md
|
|
@ -1,126 +1,29 @@
|
|||
# Fedora Release Notes
|
||||
# Fedora Release Notes Documentation
|
||||
|
||||
Please report Issues and submit Pull Requests for **Content Fixes** here.
|
||||
Never done a pull request (or "PR")? Here's the [Pagure documentation for
|
||||
Pull Requests](https://docs.pagure.org/pagure/usage/pull_requests.html).
|
||||
Release Notes document the most important changes and new features in each Fedora Linux release.
|
||||
|
||||
## Published documentation
|
||||
|
||||
General appearance issues and publishing issues should be reported against
|
||||
the [publishing software](https://pagure.io/fedora-docs/docs-fp-o).
|
||||
The published version of this documentation is available at:
|
||||
[https://docs.fedoraproject.org/en-US/fedora/latest/release-notes/](https://docs.fedoraproject.org/en-US/fedora/latest/release-notes/)
|
||||
|
||||
## Structure
|
||||
## Contributing
|
||||
|
||||
```
|
||||
|-- README.md
|
||||
|-- antora.yml ....................... 1.
|
||||
|-- build.sh ......................... 2.
|
||||
|-- preview.sh ....................... 3.
|
||||
|-- site.yml ......................... 4.
|
||||
`-- modules
|
||||
`-- ROOT ......................... 5.
|
||||
|-- assets
|
||||
| `-- images ............... 6.
|
||||
| `-- pizza.png
|
||||
|-- nav.adoc ................. 7.
|
||||
`-- pages .................... 8.
|
||||
|-- architecture.adoc
|
||||
|-- community.adoc
|
||||
|-- faq.adoc
|
||||
|-- index.adoc
|
||||
|-- pizza-dough.adoc
|
||||
`-- pizza-oven.adoc
|
||||
```
|
||||
We welcome contributions! Whether it's fixing a typo, reporting an outdated
|
||||
page, or writing new content — every little bit helps.
|
||||
|
||||
1. Metadata definition.
|
||||
2. A script that does a local build. Uses docker.
|
||||
3. A script that shows a preview of the site in a web browser by running a local web server. Uses docker.
|
||||
4. A definition file for the build script.
|
||||
5. A "root module of this documentation component". Please read below for an explanation.
|
||||
6. **Images** to be used on any page.
|
||||
7. **Menu definition.** Also defines the hierarchy of all the pages.
|
||||
8. **Pages with the actual content.** They can be also organised into subdirectories if desired.
|
||||
> **Note:** This is a versioned repository — there is a separate branch for each
|
||||
> Fedora release. Pull requests should generally go to these release-specific branches.
|
||||
> Branch `main` is only used as a template from which each new version is branched.
|
||||
|
||||
## Components and Modules
|
||||
See the [Fedora Docs Contributor Guide](https://docs.fedoraproject.org/en-US/fedora-docs/contributing-docs/)
|
||||
for how to get started.
|
||||
|
||||
Antora introduces two new terms:
|
||||
Please report **content issues** in this repository.
|
||||
For general site/publishing issues, use the
|
||||
[Fedora Docs Website repository](https://forge.fedoraproject.org/docs/docs-fp-o).
|
||||
|
||||
* **Component** — Simply put, a component is a part of the documentation website with its own menu. Components can also be versioned. In the Fedora Docs, we use separate components for user documentation, the Fedora Poject, Fedora council, Mindshare, FESCO, but also subprojects such as CommOps or Modulartity.
|
||||
* **Module** — A component can be broken down into multiple modules. Modules still share a single menu on the site, but their sources can be stored in different git repositories, even owned by different groups. The default module is called "ROOT" (that's what is in this example). If you don't want to use multiple modules, only use "ROOT". But to define more modules, simply duplicate the "ROOT" directory and name it anything you want. You can store modules in one or more git repositories.
|
||||
|
||||
## Local preview
|
||||
|
||||
This repo includes scripts to build and preview the contents of this repository.
|
||||
|
||||
**NOTE**: Please note that if you reference pages from other repositoreis, such links will be broken in this local preview as it only builds this repository. If you want to rebuild the whole Fedora Docs site, please see [the Fedora Docs build repository](https://pagure.io/fedora-docs/docs-fp-o/) for instructions.
|
||||
|
||||
Both scripts work on Fedora (using Podman) and macOS (using Docker).
|
||||
|
||||
To build and preview the site, run:
|
||||
|
||||
```
|
||||
$ ./build.sh && ./preview.sh
|
||||
```
|
||||
|
||||
The result will be available at http://localhost:8080
|
||||
|
||||
### Installing Podman on Fedora
|
||||
|
||||
Fedora Workstation doesn't come with Podman preinstalled by default — so you might need to install it using the following command:
|
||||
|
||||
```
|
||||
$ sudo dnf install podman
|
||||
```
|
||||
|
||||
### Preview as a part of the whole Fedora Docs site
|
||||
|
||||
You can also build the whole Fedora Docs site locally to see your changes in the whole context.
|
||||
This is especially useful for checking if your `xref` links work properly.
|
||||
|
||||
To do this, you need to clone the main [Fedora Docs build repository](https://pagure.io/fedora-docs/docs-fp-o), modify the `site.yml` file to reference a repo with your changes, and build it.
|
||||
Steps:
|
||||
|
||||
Clone the main repository and cd into it:
|
||||
|
||||
```
|
||||
$ git clone https://pagure.io/fedora-docs/docs-fp-o.git
|
||||
$ cd docs-fp-o
|
||||
```
|
||||
|
||||
Find a reference to the repository you're changing in the `site.yml` file, and change it so it points to your change.
|
||||
So for example, if I made a modification to the Modularity docs, I would find:
|
||||
|
||||
```
|
||||
...
|
||||
- url: https://pagure.io/fedora-docs/modularity.git
|
||||
branches:
|
||||
- master
|
||||
...
|
||||
```
|
||||
|
||||
And replaced it with a pointer to my fork:
|
||||
```
|
||||
...
|
||||
- url: https://pagure.io/forks/asamalik/fedora-docs/modularity.git
|
||||
branches:
|
||||
- master
|
||||
...
|
||||
```
|
||||
|
||||
I could also point to a local repository, using `HEAD` as a branch to preview the what's changed without the need of making a commit.
|
||||
|
||||
**Note:** I would need to move the repository under the `docs-fp-o` directory, because the builder won't see anything above.
|
||||
So I would need to create a `repositories` directory in `docs-fp-o` and copy my repository into it.
|
||||
|
||||
```
|
||||
...
|
||||
- url: ./repositories/modularity
|
||||
branches:
|
||||
- HEAD
|
||||
...
|
||||
```
|
||||
|
||||
To build the whole site, I would run the following in the `docs-fp-o` directory.
|
||||
|
||||
```
|
||||
$ ./build.sh && ./preview.sh
|
||||
```
|
||||
## Contact
|
||||
- **Matrix:** [#docs:fedoraproject.org](https://matrix.to/#/#docs:fedoraproject.org)
|
||||
- **Private comms:** Use our FAS emails for anything that shouldn't be public.
|
||||
- **Discussion forums:** [discussion.fedoraproject.org](https://discussion.fedoraproject.org/tag/docs-team/337)
|
||||
|
|
@ -1,5 +1,5 @@
|
|||
---
|
||||
name: fedora
|
||||
version: f37
|
||||
version: rawhide
|
||||
# Navigation is in the main 'fedora' component:
|
||||
# https://pagure.io/fedora-docs/release-docs-home
|
||||
|
|
|
|||
|
|
@ -1,32 +1,10 @@
|
|||
include::{partialsdir}/entities.adoc[]
|
||||
include::partial$entities.adoc[]
|
||||
|
||||
* xref:index.adoc[Fedora Release Notes]
|
||||
** xref:welcome/Welcome.adoc[Welcome to Fedora]
|
||||
*** xref:welcome/Hardware_Overview.adoc[Hardware Overview]
|
||||
*** xref:welcome/Feedback.adoc[Feedback]
|
||||
** xref:sysadmin/Sysadmins.adoc[System Administrators]
|
||||
*** xref:sysadmin/Distribution.adoc[Distribution-wide Changes]
|
||||
*** xref:sysadmin/Installation.adoc[Installation]
|
||||
*** xref:sysadmin/Security.adoc[Security]
|
||||
*** xref:sysadmin/Networking.adoc[Networking]
|
||||
*** xref:sysadmin/Storage.adoc[Storage]
|
||||
*** xref:sysadmin/System_Utilities.adoc[System Utilities]
|
||||
*** xref:sysadmin/Printing_Scanning.adoc[Printing and Scanning]
|
||||
*** xref:sysadmin/Mail_Servers.adoc[Mail Servers]
|
||||
*** xref:sysadmin/Ostree.adoc[Ostree based variants]
|
||||
** xref:desktop/Desktop_index.adoc[Desktop Users]
|
||||
*** xref:desktop/I18n.adoc[Internationalization]
|
||||
*** xref:desktop/Multimedia.adoc[Multimedia]
|
||||
** xref:developers/Developers.adoc[Developers]
|
||||
*** xref:developers/Development_Tools.adoc[Development Tools]
|
||||
*** xref:developers/Development_Binutils.adoc[Binutils]
|
||||
*** xref:developers/Development_C.adoc[C]
|
||||
*** xref:developers/Development_Go.adoc[Go]
|
||||
*** xref:developers/Development_Haskell.adoc[Haskell]
|
||||
*** xref:developers/Development_LLVM.adoc[LLVM]
|
||||
*** xref:developers/Development_Dotnet.adoc[.NET]
|
||||
*** xref:developers/Development_Python.adoc[Python]
|
||||
*** xref:developers/Development_Ruby.adoc[Ruby]
|
||||
*** xref:developers/Development_Web.adoc[Web Development]
|
||||
** xref:welcome.adoc[Welcome to Fedora]
|
||||
*** xref:hardware_overview.adoc[Hardware Overview]
|
||||
*** xref:feedback.adoc[Feedback]
|
||||
** xref:sysadmin.adoc[System Administrators]
|
||||
** xref:desktop.adoc[Desktop Users]
|
||||
** xref:developers.adoc[Developers]
|
||||
** link:{COMMONBUGS_URL}[Common Bugs]
|
||||
** xref:Revision_History.adoc[Revision History]
|
||||
|
|
|
|||
|
|
@ -1,5 +0,0 @@
|
|||
|
||||
include::{partialsdir}/entities.adoc[]
|
||||
|
||||
[[appe-Release_Notes-Revision_History]]
|
||||
= Revision History
|
||||
|
|
@ -1 +0,0 @@
|
|||
.The Fedora Docs Team
|
||||
|
|
@ -1,8 +0,0 @@
|
|||
:BOOKID: release-notes
|
||||
:BZURL: https://pagure.io/fedora-docs/release-notes/issues
|
||||
:COMMONBUGS_URL: https://ask.fedoraproject.org/tags/c/common-issues/f37
|
||||
:HOLDER: Fedora Project Contributors
|
||||
:PREVVER: 36
|
||||
:PRODUCT: Fedora Documentation
|
||||
:PRODVER: 37
|
||||
:YEAR: 2022
|
||||
4
modules/release-notes/pages/desktop.adoc
Normal file
4
modules/release-notes/pages/desktop.adoc
Normal file
|
|
@ -0,0 +1,4 @@
|
|||
:experimental:
|
||||
include::partial$entities.adoc[]
|
||||
|
||||
= Changes in Fedora {PRODVER} For Desktop Users
|
||||
|
|
@ -1,8 +0,0 @@
|
|||
include::{partialsdir}/entities.adoc[]
|
||||
|
||||
= Notable changes for desktop users
|
||||
|
||||
[[pantheon-removal]]
|
||||
== Pantheon Desktop Environment has been removed from Fedora
|
||||
|
||||
Due to massive changes in the core technology stack of GNOME 43 (i.e. the switch to libsoup-3.0, webkit2gtk-4.1, geoclue-glib-2.0, rest-1, gcr-4), the Pantheon Desktop Environment and various elementary applications, which do not yet support the latest versions of these libraries, will no longer be supported or available as of Fedora 37.
|
||||
|
|
@ -1,29 +0,0 @@
|
|||
include::{partialsdir}/entities.adoc[]
|
||||
:experimental:
|
||||
|
||||
[[sect-i18n]]
|
||||
= Internationalization
|
||||
|
||||
[[ibus]]
|
||||
== IBus 1.5.27
|
||||
* `ibus restart` subcommand is enhanced for the GNOME desktop session. Previously `ibus restart` subcommand failed to restart ibus-daemon but now it’s also connected to systemd by default. The other options can be shown with `ibus restart --help` subcommand.
|
||||
* `ibus im-module` subcommand is added newly to get an internal gtk-im-module value from an instance of an GTK instance and this subcommand would be useful in case that users install IBus input method framework by manual and they check if IBus is installed properly.
|
||||
* IBus Emoji shortcut key is now reverted to kbd:[🪟+.](Super+Period).
|
||||
* IBus theme of the candidate window can be customized with ibus-setup utility in non-GNOME desktop sessions. IBus theme has inherited the GTK themes in the desktop session by default and this is useful for other desktop sessions likes KDE.
|
||||
|
||||
== ibus-libpinyin 1.13
|
||||
The ibus-libpinyin package will make English input and Table input in the "Intelligent Pinyin" input method easier.
|
||||
|
||||
[[gettext-runtime]]
|
||||
== Gettext Runtime Subpackage
|
||||
Two subpackages gettext-runtime and gettext-envsubst have been added to gettext to separate out the programs needed at runtime, reducing the default install footprint.
|
||||
|
||||
[[enhanced-persian-fonts]]
|
||||
== Enhanced Persian font support
|
||||
|
||||
In previous Fedora releases, the Persian (fa) locale used multiple different fonts such as DejaVu and Noto Sans Arabic for various programs, leading to an inconsistent and suboptimal experience. Fedora 37 adds the `vazirmatn-vf-fonts` package containing the Vazirmatn font, which is now used by default everywhere, providing improved user experience to those who use the `fa` locale.
|
||||
|
||||
[[firefox-langpacks]]
|
||||
== Firefox now has a langpacks subpackage
|
||||
|
||||
Firefox's langpacks are now installed in a separate recommended subpackage for greater flexibility. This enhances Fedora's modularity and allows you to install Firefox without support for all available languages if not needed.
|
||||
|
|
@ -1,20 +0,0 @@
|
|||
include::{partialsdir}/entities.adoc[]
|
||||
|
||||
[[sect-multimedia]]
|
||||
= Multimedia
|
||||
|
||||
[[mumble-1-4]]
|
||||
== Mumble 1.4
|
||||
|
||||
Mumble is a popular voice chat application. It is commonly used for gaming and podcasts.
|
||||
|
||||
This update brings for example the following changes:
|
||||
|
||||
* Enable the native PipeWire audio backend
|
||||
* Rename the Mumble server package from `murmur` to `mumble-server`
|
||||
* Relocate the Mumble server configuration file from `/etc/murmur/murmur.ini` to `/etc/murmur.ini`
|
||||
* Introduce a new, general purpose plugin framework
|
||||
* Substitute a sub-optimal free-type search for a fully featured search dialog
|
||||
* Support markdown markup language for text messages in the chat bar
|
||||
|
||||
You can see the full list of changes in the https://www.mumble.info/blog/mumble-1.4.230/[upstream release notes].
|
||||
|
|
@ -1,2 +0,0 @@
|
|||
= Notable changes for desktop users
|
||||
:page-aliases: Desktop_index.adoc
|
||||
4
modules/release-notes/pages/developers.adoc
Normal file
4
modules/release-notes/pages/developers.adoc
Normal file
|
|
@ -0,0 +1,4 @@
|
|||
:experimental:
|
||||
include::partial$entities.adoc[]
|
||||
|
||||
= Changes in Fedora {PRODVER} For Developers
|
||||
|
|
@ -1,6 +0,0 @@
|
|||
include::{partialsdir}/entities.adoc[]
|
||||
|
||||
= Notable changes for developers
|
||||
|
||||
This section lists changes in Fedora {PRODVER} relevant to developers.
|
||||
Use the navigation tab on the left to view release notes for various languages.
|
||||
|
|
@ -1,4 +0,0 @@
|
|||
include::{partialsdir}/entities.adoc[]
|
||||
|
||||
[[sect-binutils]]
|
||||
= GNU Binutils
|
||||
|
|
@ -1,11 +0,0 @@
|
|||
|
||||
include::{partialsdir}/entities.adoc[]
|
||||
|
||||
[[sect-c]]
|
||||
= C
|
||||
|
||||
|
||||
[[mingw]]
|
||||
== MinGW updates
|
||||
|
||||
Fedora 37 comes with the mingw-gcc-12 and mingw-binutils-2.38, and mingw-openssl-3.x. The new MinGW toolchain and tools are available to compile binaries targeting the Windows UCRT.
|
||||
|
|
@ -1,5 +0,0 @@
|
|||
|
||||
include::{partialsdir}/entities.adoc[]
|
||||
|
||||
[[sect-dotnet]]
|
||||
= .NET
|
||||
|
|
@ -1,5 +0,0 @@
|
|||
|
||||
include::{partialsdir}/entities.adoc[]
|
||||
|
||||
[[sect-development-go]]
|
||||
= Golang
|
||||
|
|
@ -1,11 +0,0 @@
|
|||
|
||||
include::{partialsdir}/entities.adoc[]
|
||||
|
||||
[[sect-haskell]]
|
||||
= Haskell
|
||||
The Haskell GHC compiler has been updated from 8.10.5 to 8.10.7
|
||||
with some important bugfixes. Haskell packages were updated
|
||||
to final Stackage 18.28 versions.
|
||||
|
||||
Newer versions of GHC are available via the
|
||||
ghc9.0, ghc9.2, and ghc9.4 packages.
|
||||
|
|
@ -1,9 +0,0 @@
|
|||
|
||||
include::{partialsdir}/entities.adoc[]
|
||||
|
||||
[[sect-llvm]]
|
||||
= LLVM version 15
|
||||
|
||||
All LLVM sub-projects in Fedora have been updated to version 15, and there has been be a soname version change for the LLVM libraries. Compatibility packages `clang14` and `llvm14` are available to ensure that packages that currently depend on CLang and LLVM version 14 libraries will continue to work.
|
||||
|
||||
A full list of changes in LLVM 15 is available in the link:https://releases.llvm.org/15.0.0/docs/ReleaseNotes.html[upstream LLVM Release Notes].
|
||||
|
|
@ -1,42 +0,0 @@
|
|||
|
||||
include::{partialsdir}/entities.adoc[]
|
||||
|
||||
[[sect-python]]
|
||||
= Python
|
||||
|
||||
== Python 3.11
|
||||
|
||||
Fedora 37 provides the Python stack in version 3.11, up from version 3.10 in the previous release. Notable changes include:
|
||||
|
||||
* Exception Groups and `except*`
|
||||
* Enhanced error locations in tracebacks
|
||||
* Support for parsing TOML in the standard library
|
||||
* A massive speed improvement compared to Python 3.10
|
||||
|
||||
Typing features:
|
||||
|
||||
* Variadic generics
|
||||
* Marking individual `TypedDict` items as required or potentially-missing
|
||||
* Self type
|
||||
* Arbitrary literal string type
|
||||
* Dataclass transforms
|
||||
|
||||
For a full list of changes, see the link:https://docs.python.org/3.11/whatsnew/3.11.html[What's New In Python 3.11] upstream document. Also see link:https://docs.python.org/3.11/whatsnew/3.11.html#porting-to-python-3-11[Porting to Python 3.11] if you have Python programs running on an older version.
|
||||
|
||||
[[default-shebangs]]
|
||||
== Add -P to default shebangs
|
||||
|
||||
All Python 3 shebang RPM macros in Fedora 37 have been changed to contain one more flag: `-P`. Previously, they contained `-s`, now they contain `-sP`. The `-P` flag was introduced in Python 3.11.
|
||||
|
||||
The new flag stops Python from prepending a potentially unsafe path to `sys.path`. This causes Python programs in `/usr/bin` to be less fragile towards random files present in the same directory, making debugging certain types of issues easier and enhancing security.
|
||||
|
||||
The following RPM macros are affected by this change:
|
||||
|
||||
* `%{py3_shbang_opts}`
|
||||
* `%{py3_shbang_opts_nodash}`
|
||||
* `%{py3_shebang_flags}`
|
||||
* `%{py_shbang_opts}`
|
||||
* `%{py_shbang_opts_nodash}`
|
||||
* `%{py_shebang_flags}`
|
||||
|
||||
For a detailed explanation of what this change means, a list of affected packages, and information on how to opt out of this change (or explicitly opt in) if needed, see the link:https://fedoraproject.org/wiki/Changes/PythonSafePath#Detailed_Description[Fedora Wiki].
|
||||
|
|
@ -1,4 +0,0 @@
|
|||
include::{partialsdir}/entities.adoc[]
|
||||
|
||||
[[sect-ruby]]
|
||||
= Ruby
|
||||
|
|
@ -1,16 +0,0 @@
|
|||
include::{partialsdir}/entities.adoc[]
|
||||
:experimental:
|
||||
|
||||
[[sect-development-tools]]
|
||||
= Development Tools
|
||||
|
||||
[[emacs-28]]
|
||||
== Emacs 28
|
||||
|
||||
Fedora 37 provides the Emacs editor version 28.1. Notable new features include:
|
||||
|
||||
* Native compilation of Lisp files
|
||||
* Much improved display of Emoji and Emoji sequences
|
||||
* New system for documenting groups of functions
|
||||
|
||||
For more information, see the link:https://www.gnu.org/software/emacs/news/NEWS.28.1[upstream Emacs 28.1 NEWS]. You can also access this information within Emacs itself by pressing kbd:[C-h] kbd:[n].
|
||||
|
|
@ -1,20 +0,0 @@
|
|||
|
||||
include::{partialsdir}/entities.adoc[]
|
||||
|
||||
[[sect-web-development]]
|
||||
= Web Development
|
||||
|
||||
== Node.js 18
|
||||
|
||||
Fedora 37 ships with the latest LTS version of Node.js JavaScript server-side engine, 18.x. The 16.x, and 14.x interpreters will remain available as non-default module streams.
|
||||
|
||||
If your applications are not yet ready for this newer version, you can revert to the 16.x series by running the following commands:
|
||||
|
||||
[source,bash]
|
||||
----
|
||||
dnf remove nodejs
|
||||
dnf module reset nodejs
|
||||
dnf module install nodejs:16
|
||||
----
|
||||
|
||||
For more detailed information about Node.js 18, see the link:https://github.com/nodejs/node/blob/main/doc/changelogs/CHANGELOG_V18.md[upstream Node.js 18 ChangeLog].
|
||||
|
|
@ -1,2 +0,0 @@
|
|||
= Notable changes for developers
|
||||
:page-aliases: Developers.adoc
|
||||
|
|
@ -1,5 +1,5 @@
|
|||
|
||||
include::{partialsdir}/entities.adoc[]
|
||||
include::partial$entities.adoc[]
|
||||
|
||||
[[sect-Release_Notes-Feedback]]
|
||||
= Feedback
|
||||
|
|
@ -8,7 +8,7 @@ Thank you for taking the time to provide your comments, suggestions, and bug rep
|
|||
|
||||
== Providing Feedback on Fedora Software
|
||||
|
||||
To provide feedback on Fedora software or other system elements, please refer to link:++https://fedoraproject.org/wiki/BugsAndFeatureRequests++[Bugs And Feature Requests]. A list of commonly reported bugs and known issues for this release is available from link:{COMMONBUGS_URL}[Common Bugs] on the wiki.
|
||||
To provide feedback on Fedora software or other system elements, please refer to link:++https://docs.fedoraproject.org/en-US/quick-docs/bugzilla-file-a-bug/++[Bugs And Feature Requests]. A list of commonly reported bugs and known issues for this release is available from link:{COMMONBUGS_URL}[Common Bugs] on the forums.
|
||||
|
||||
== Providing Feedback on Release Notes
|
||||
|
||||
|
|
@ -1,4 +1,4 @@
|
|||
include::{partialsdir}/entities.adoc[]
|
||||
include::partial$entities.adoc[]
|
||||
|
||||
[[sect-hardware-overview]]
|
||||
= Hardware Overview
|
||||
|
|
@ -29,7 +29,7 @@ For best results on systems with less than 1GB of memory, use the DVD installati
|
|||
|
||||
The figures below are recommended for the default x86_64 Workstation installation featuring the Gnome desktop . Your requirements may differ, depending on Desktop Environment and use case.
|
||||
|
||||
* 2GHz quad core processor
|
||||
* 2GHz quad core processor
|
||||
|
||||
* 4GB System Memory
|
||||
|
||||
|
|
@ -46,15 +46,9 @@ For best results on systems with less than 1GB of memory, use the DVD installati
|
|||
[[hardware_overview-resolution]]
|
||||
== Display resolution
|
||||
|
||||
VGA capable of 1024x768 screen resolution
|
||||
|
||||
.Graphical Installation requires 800x600 resolution or higher
|
||||
[NOTE]
|
||||
====
|
||||
Graphical installation of Fedora requires a minimum screen resolution of 800x600. Owners of devices with lower resolution, such as some netbooks, should use text or VNC installation.
|
||||
Graphical installation of Fedora requires a minimum screen resolution of **1024x768**. Owners of devices with lower resolution, such as some netbooks, should use text or VNC installation.
|
||||
|
||||
Once installed, Fedora will support these lower resolution devices. The minimum resolution requirement applies only to graphical installation.
|
||||
====
|
||||
|
||||
[[hardware_overview-graphics]]
|
||||
== Graphics Hardware
|
||||
|
|
@ -62,7 +56,7 @@ Once installed, Fedora will support these lower resolution devices. The minimum
|
|||
[[hardware_overview-graphics-legacy_gpus]]
|
||||
=== Minimum Hardware for Accelerated Desktops
|
||||
|
||||
Fedora {PRODVER} supports most display adapters. Modern, feature-rich desktop environments like *GNOME3* and *KDE Plasma Workspaces* use video devices to provide 3D-accelerated desktops. Older graphics hardware may *not support* acceleration:
|
||||
Fedora {PRODVER} supports most display adapters. Modern, feature-rich desktop environments like *GNOME* and *KDE Plasma Workspaces* use video devices to provide 3D-accelerated desktops. Older graphics hardware may *not support* acceleration:
|
||||
|
||||
* Intel prior to GMA9xx
|
||||
|
||||
|
|
@ -78,22 +72,18 @@ Systems with older or no graphics acceleration devices can have accelerated desk
|
|||
[[hardware_overview-graphics-desktops]]
|
||||
=== Choosing a Desktop Environment for your hardware
|
||||
|
||||
Fedora {PRODVER}'s default desktop environment, *GNOME3*, functions best with hardware acceleration. Alternative desktops are recommended for users with older graphics hardware or those seeing insufficient performance with *LLVMpipe*.
|
||||
Fedora {PRODVER}'s default desktop environment, *GNOME*, functions best with hardware acceleration. Alternative desktops are recommended for users with older graphics hardware or those seeing insufficient performance with *LLVMpipe*.
|
||||
|
||||
Desktop environments can be added to an existing installation and selected at login. To list the available desktops, use the [command]`dnf grouplist` command:
|
||||
Desktop environments can be added to an existing installation and selected at login. To list the available desktops, use the [command]`dnf environment list` command:
|
||||
|
||||
----
|
||||
# dnf grouplist -v hidden | grep Desktop
|
||||
# dnf environment list
|
||||
----
|
||||
|
||||
Install the desired group:
|
||||
Install the desired environment using its ID as listed in the above command's output:
|
||||
|
||||
----
|
||||
# dnf groupinstall "KDE Plasma Workspaces"
|
||||
# dnf install @cinnamon-desktop-environment
|
||||
----
|
||||
|
||||
Or, use the short group name to install:
|
||||
|
||||
----
|
||||
# dnf install @mate-desktop-environment
|
||||
----
|
||||
For more information, see the `dnf5-environment` man page.
|
||||
|
|
@ -1,4 +1,4 @@
|
|||
include::{partialsdir}/entities.adoc[]
|
||||
include::partial$entities.adoc[]
|
||||
|
||||
= Release Notes
|
||||
|
||||
|
|
@ -14,7 +14,7 @@ This document provides the release notes for Fedora Linux {PRODVER}. It describe
|
|||
====
|
||||
Have something that should be included in the release notes?
|
||||
Notice something wrong?
|
||||
File an issue in the https://pagure.io/fedora-docs/release-notes[fedora-docs/release-notes repo].
|
||||
File an issue in the https://gitlab.com/fedora/docs/fedora-linux-documentation/release-notes/-/issues[Release Notes repository].
|
||||
====
|
||||
|
||||
[NOTE]
|
||||
|
|
@ -23,6 +23,4 @@ Use the sidebar on the left to navigate the Release Notes as well as other docum
|
|||
====
|
||||
|
||||
image:title_logo.svg[Fedora Logo]
|
||||
include::{partialsdir}/Legal_Notice.adoc[]
|
||||
|
||||
include::{partialsdir}/Author_Group.adoc[]
|
||||
include::partial$Legal_Notice.adoc[]
|
||||
|
|
|
|||
4
modules/release-notes/pages/sysadmin.adoc
Normal file
4
modules/release-notes/pages/sysadmin.adoc
Normal file
|
|
@ -0,0 +1,4 @@
|
|||
:experimental:
|
||||
include::partial$entities.adoc[]
|
||||
|
||||
= Changes in Fedora {PRODVER} For System Administrators
|
||||
|
|
@ -1,60 +0,0 @@
|
|||
include::{partialsdir}/entities.adoc[]
|
||||
|
||||
[[select-distribution]]
|
||||
= Distribution-wide Changes
|
||||
|
||||
[[raspberry-pi-4]]
|
||||
== Official support for Raspberry Pi 4
|
||||
|
||||
This Fedora update brings support for Raspberry Pi 4, including 4B, the 400 unit, and the Compute Module (CM) 4 IO Board. All the mentioned models support also accelerated graphics using the V3D GPU for both OpenGL-ES and Vulkan.
|
||||
|
||||
Some minor caveats include:
|
||||
|
||||
* Support for WiFi on the Raspberry Pi 400 is out of scope of this change.
|
||||
* We tested CM 4 and will support on the official IO board. Other devices that incorporate CM 4 should work correctly provided the vendor has their support in the upstream Raspberry Pi firmware/overlays.
|
||||
* The hardware based media decoding (H264/HVEC, and others) are out of scope for this change.
|
||||
|
||||
[[retire-armv7]]
|
||||
== ARMv7 architecture is no longer supported
|
||||
|
||||
Fedora 37 drops support for older ARM devices using the ARMv7 (also known as arm32 or armhfp) architecture. Such devices running older Fedora releases will not be able to upgrade, and will not be able to do a fresh Fedora 37 installation.
|
||||
|
||||
[[server-kvm-image]]
|
||||
== Fedora Server Edition available as KVM virtual machine disk image
|
||||
|
||||
Fedora Server provides now a virtual disk image to greatly facilitate installation of Fedora Server VMs. It allows an immediate installation by either Cockpit administration WEB UI or one of the CLI tools.
|
||||
|
||||
The image is optimized for KVM and aims to resemble a default server installation as closely as possible. All administrative tools are available reliably from the beginning, all administrative routines and helps (scripts) can be used in the same way. All application services work the same as in the standard installation.
|
||||
|
||||
The server documentation link:https://docs.fedoraproject.org/en-US/fedora-server/virtualization/vm-install-diskimg-fedoraserver/[Creating a virtual machine using Fedora Server Edition disk image] provides detailed information on installing and using the disk image.
|
||||
|
||||
[[eln]]
|
||||
== ELN Extras
|
||||
The ELN project will now run "ELN-Extras", a new build target and compose similar to ELN in behavior, but closer in function to EPEL. It will be a place to prepare and maintain packages that may be desired for EPEL N+1 while RHEL N+1 is still being incubated in ELN. This will enable application developers to keep up with impending changes in RHEL even before CentOS Stream becomes available for that release. Additionally, it provides a bootstrapping mechanism for EPEL, which will mean a much shorter gap between the launch of a new RHEL major release and the availability of the EPEL repositories.
|
||||
|
||||
See the link:https://docs.fedoraproject.org/en-US/eln/[Fedora ELN Project] documentation for more information about the project, including link:https://docs.fedoraproject.org/en-US/eln/extras/[Extras].
|
||||
|
||||
[[pantheon-removal]]
|
||||
== Pantheon Desktop Environment has been removed from Fedora
|
||||
|
||||
See xref:desktop/Desktop_index.adoc#pantheon-removal[Desktop].
|
||||
|
||||
[[boot-iso-grub2]]
|
||||
== boot.iso now uses GRUB2 on BIOS systems
|
||||
|
||||
See xref:sysadmin/Installation.adoc#boot-iso-grub2[Distribution].
|
||||
|
||||
== Python3 packages are now built with -P
|
||||
|
||||
See xref:developers/Development_Python.adoc#default-shebangs[Python].
|
||||
|
||||
== Fedora Cloud Base is now a Fedora Edition
|
||||
|
||||
Fedora Cloud Base has been promoted to official status as a Fedora Edition. Cloud Base images can now be downloaded from link:https://alt.fedoraproject.org/cloud/[Get Fedora].
|
||||
|
||||
[[coreos-edition]]
|
||||
== Fedora CoreOS is now a Fedora Edition
|
||||
|
||||
Fedora CoreOS has been promoted to official status as a Fedora Edition. CoreOS images can now be downloaded from link:https://getfedora.org/en/coreos?stream=stable[Get Fedora].
|
||||
|
||||
Documentation for Fedora CoreOS is available at link:https://docs.fedoraproject.org/en-US/fedora-coreos/[this docs site].
|
||||
|
|
@ -1,14 +0,0 @@
|
|||
|
||||
include::{partialsdir}/entities.adoc[]
|
||||
|
||||
[[sect-installation]]
|
||||
= Installation
|
||||
|
||||
== Anaconda and related components
|
||||
|
||||
Release notes for the Fedora installer, Anaconda, as well as related topics, are now being maintained upstream. See the project's link:https://anaconda-installer--4379.org.readthedocs.build/en/4379/release-notes.html#fedora-37[ReadTheDocs] documentation for a full list of installer-related changes in Fedora 37.
|
||||
|
||||
[[boot-iso-grub2]]
|
||||
== boot.iso now uses GRUB2 on BIOS systems
|
||||
|
||||
In previous Fedora releases, the minimal installer image (`boot.iso`) used the syslinux bootloader when booting on systems using BIOS firmware, while on UEFI systems GRUB2 is used. However, the syslinux project is no longer being developed upstream. Therefore, starting with Fedora 37, `boot.iso` images will use GRUB2 on both BIOS and UEFI-based systems.
|
||||
|
|
@ -1,24 +0,0 @@
|
|||
include::{partialsdir}/entities.adoc[]
|
||||
|
||||
= Mail servers
|
||||
|
||||
== roundcubemail 1.6
|
||||
|
||||
Roundcube Webmail has been updated to version 1.6 in Fedora 37. Note that this version contains a set of breaking changes to previous versions; the following configuration options have been either removed or renamed:
|
||||
|
||||
* IMAP
|
||||
** renamed `default_host` to `imap_host`
|
||||
** removed `default_port` option (non-standard port can be set via `imap_host`)
|
||||
** set `localhost:143` as a default for `imap_host`
|
||||
* SMTP
|
||||
** renamed `smtp_server` to `smtp_host`
|
||||
** removed `smtp_port` option (non-standard port can be set via `smtp_host`)
|
||||
** set `localhost:587` as a default for `smtp_host`
|
||||
* LDAP
|
||||
** removed `port` option from `ldap_public` array (non-standard port can be set via `host`)
|
||||
** removed `use_tls` option from `ldap_public` array (use `tls://` prefix in `host`)
|
||||
* Managesieve
|
||||
** removed `managesieve_port` option (non-standard port can be set via `managesieve_host`)
|
||||
** removed `managesieve_usetls` option (set `tls://` prefix to `managesieve_host`)
|
||||
|
||||
For a list of changes, see the link:https://github.com/roundcube/roundcubemail/releases/tag/1.6.0[upstream Rouncube Webmail release notes].
|
||||
|
|
@ -1,27 +0,0 @@
|
|||
|
||||
include::{partialsdir}/entities.adoc[]
|
||||
|
||||
[[networking]]
|
||||
= Networking
|
||||
|
||||
|
||||
== BIND 9
|
||||
|
||||
Berkeley Internet Name Domain (BIND) software suite was updated to version 9.18.x. This version brings the following notable changes, for example:
|
||||
|
||||
* Support for DNS over TLS and DNS over HTTPS servers. Both authoritative and resolver modes.
|
||||
* Re-work of internal connection handling using the `libuv` library.
|
||||
* Remote Name Daemon Control (RNDC) channel does not support Unix sockets.
|
||||
* Support for incoming and outgoing DNS zone transfer over TLS.
|
||||
* Domain Information Groper (dig) utility can send queries using DNS over TLS and DNS over HTTPS.
|
||||
|
||||
[NOTE]
|
||||
====
|
||||
The `bind-dyndb-ldap` dynamic LDAP back-end was upgraded to version 11.10 to support support BIND 9.18. The back-end will be built together with the `bind` package.
|
||||
====
|
||||
|
||||
You can see the full list of changes in the https://bind9.readthedocs.io/en/v9_18_4/notes.html#notes-for-bind-9-18-0[upstream release notes].
|
||||
|
||||
== Fallback hostname set to `localhost` on server-based editions
|
||||
|
||||
For the Cloud, CoreOS, IoT, and Server editions of Fedora, the fallback hostname has been changed to `localhost`. The fallback hostname is the hostname that is set if the hostname cannot be determined by any other mechanism (statically set, DHCP, or reverse DNS). This change was made in order to conform to the common expectation that a hostname of `localhost` on a system means the hostname is "unset".
|
||||
|
|
@ -1,28 +0,0 @@
|
|||
include::{partialsdir}/entities.adoc[]
|
||||
|
||||
= Changes for ostree based variants of Fedora
|
||||
|
||||
This page regroups changes that only apply to ostree/rpm-ostree based variants of Fedora, such as Fedora CoreOS, Fedora IoT, Fedora Silverblue and Fedora Kinoite.
|
||||
|
||||
[[fedora-coreos-major-changes]]
|
||||
== Fedora CoreOS major changes
|
||||
|
||||
Major changes for Fedora CoreOS are list in the https://docs.fedoraproject.org/en-US/fedora-coreos/major-changes/[Major Changes page] in the https://docs.fedoraproject.org/en-US/fedora-coreos/[Fedora CoreOS documentation].
|
||||
|
||||
[[readonly-sysroot-ostree-desktopsl]]
|
||||
== `/sysroot` mounted read only
|
||||
|
||||
On rpm-ostree based systems, the real root (the root directory of the root partition on the disk) is mounted under the `/sysroot` path.
|
||||
By default it contains the state of the system (the content of `/var` and `/etc`) as well as the system versions themselves (each versioned copy of `/usr`) in the ostree repository (`/ostree/repo`).
|
||||
|
||||
Users and administrators are not expected to directly interact with the content available there and should instead use the interface offered by rpm-ostree, GNOME Software or soon Plasma Discover to manage their system.
|
||||
|
||||
Thus `/sysroot` is now mounted read only starting with this release.
|
||||
|
||||
New installations of all three variants will have `/sysroot` read only by default.
|
||||
|
||||
Existing installations of Fedora Silverblue and Fedora Kinoite will be migrated on the first boot to Fedora 37 and will have `/sysroot` read only on the next boot.
|
||||
|
||||
Fedora CoreOS has already made this change in a previous release (https://github.com/coreos/fedora-coreos-tracker/issues/1232[fedora-coreos-tracker#1232]).
|
||||
|
||||
See the https://fedoraproject.org/wiki/Changes/Silverblue_Kinoite_readonly_sysroot[Fedora change page] for more details.
|
||||
|
|
@ -1,4 +0,0 @@
|
|||
include::{partialsdir}/entities.adoc[]
|
||||
|
||||
[[sect-printing-scanning]]
|
||||
= Printing and Scanning
|
||||
|
|
@ -1,18 +0,0 @@
|
|||
|
||||
include::{partialsdir}/entities.adoc[]
|
||||
|
||||
[[sect-security]]
|
||||
= Security
|
||||
|
||||
[[fido-onboarding]]
|
||||
== Fedora IoT supports FIDO device onboarding
|
||||
|
||||
The ability for an IoT or Edge device to be plugged in and automatically onboard itself with zero user interaction is critical for scaling. To do this in a secure way with open standards is even more critical. Therefore, the FIDO IoT working group has collaborated with leaders in the silicon industry to produce the FIDO Device Onboarding specification.
|
||||
|
||||
With this update, Fedora IoT provides the FIDO Device Onboarding software stack for Zero Touch Onboarding.
|
||||
|
||||
The aim is to demonstrate the use of the leading edge open industry protocols for onboarding IoT and Edge devices.
|
||||
|
||||
== Python3 packages are now built with -P
|
||||
|
||||
See xref:developers/Development_Python.adoc#default-shebangs[Python].
|
||||
|
|
@ -1,18 +0,0 @@
|
|||
|
||||
include::{partialsdir}/entities.adoc[]
|
||||
|
||||
[[sect-storage]]
|
||||
= Storage
|
||||
|
||||
== Stratis 3.2.0
|
||||
The upgrade to Stratis 3.2.0 includes the following significant new features:
|
||||
|
||||
* In https://stratis-storage.github.io/stratis-release-notes-3-1-0/[Stratis 3.1.0],
|
||||
a complete redesign and reimplementation of thinpool block layer management.
|
||||
See https://stratis-storage.github.io/thin-provisioning-redesign/[the separate blog post]
|
||||
for more detailed discussion of the redesign.
|
||||
* In https://stratis-storage.github.io/stratis-release-notes-3-2-0/[Stratis 3.2.0], the ability to stop and to start individual pools.
|
||||
|
||||
Please see
|
||||
https://github.com/stratis-storage/stratisd/blob/master/CHANGES.txt[the stratisd changelog] and
|
||||
https://github.com/stratis-storage/stratis-cli/blob/master/CHANGES.txt[the stratis-cli changelog] for further details.
|
||||
|
|
@ -1,6 +0,0 @@
|
|||
include::{partialsdir}/entities.adoc[]
|
||||
|
||||
= Notable changes for system administrators
|
||||
|
||||
This section lists changes in Fedora {PRODVER} relevant to system administrators.
|
||||
Use the navigation tab on the left to view release notes for various fields of interest.
|
||||
|
|
@ -1,34 +0,0 @@
|
|||
include::{partialsdir}/entities.adoc[]
|
||||
|
||||
[[sect-system-utilities]]
|
||||
= System Utilities
|
||||
|
||||
[[rpm-4-18]]
|
||||
== RPM 4.18
|
||||
|
||||
RPM 4.18 contains various improvements over previous versions, but in particular this release addresses a whole class of symlink handling related security issues, some with CVEs, from 2021. Other notable improvements include:
|
||||
|
||||
* A more intuitive conditional builds macro `%bcond`
|
||||
* A more robust and secure `--restore` functionality
|
||||
* Long-standing `%patch` quirks fixed
|
||||
* Weak dependencies accept qualifiers like `meta` and `pre` now
|
||||
* New interactive shell for working with macros (`rpmspec --shell`) and embedded Lua (`rpmlua`)
|
||||
* New `%conf` spec section for build configuration
|
||||
* New `rpmuncompress` cli tool simplifies unpacking multiple sources
|
||||
* Numerous macro improvements and fixes
|
||||
* Numerous OpenPGP parser correctness and security fixes
|
||||
|
||||
For more detailed information see the link:https://rpm.org/wiki/Releases/4.18.0[upstream RPM 4.18 Release Notes].
|
||||
|
||||
|
||||
[[preset-all-systemd-units-on-first-boot]]
|
||||
== Preset all systemd units on first boot
|
||||
|
||||
On a Fedora system you booted from an image without the fully populated `/etc/` directory (https://www.freedesktop.org/software/systemd/man/machine-id.html#First%20Boot%20Semantics[First Boot]), `systemd` will execute an equivalent of the `systemctl preset-all` command. As a result, units will be enabled or disabled according to the preset configuration.
|
||||
|
||||
[NOTE]
|
||||
====
|
||||
The `systemd` service manager will disable any units, to which you manually created symbolic links against the preset rules.
|
||||
====
|
||||
|
||||
You can use the `systemctl preset-all` command at any time to apply the preset configuration. If you did not make any prior local changes to the configuration, the command would make no changes to unit state. If you enabled or disabled some units, the command would return unit enablement to the after-installation pristine state.
|
||||
|
|
@ -1,2 +0,0 @@
|
|||
= Notable changes for system administrators
|
||||
:page-aliases: Sysadmins.adoc
|
||||
|
|
@ -1,4 +1,4 @@
|
|||
include::{partialsdir}/entities.adoc[]
|
||||
include::partial$entities.adoc[]
|
||||
|
||||
[[sect-welcome_to_fedora]]
|
||||
= Welcome to Fedora
|
||||
|
|
@ -13,26 +13,26 @@ The Fedora Project's mission is to lead the advancement of free and open source
|
|||
|
||||
* The Fedora Project succeeds through shared action on the part of many people throughout our community.
|
||||
|
||||
To find out more general information about Fedora, refer to the following pages, on the Fedora Project Wiki:
|
||||
To find out more general information about Fedora, refer to the following pages:
|
||||
|
||||
* link:++https://fedoraproject.org/wiki/Overview++[Fedora Overview]
|
||||
* link:++https://docs.fedoraproject.org/en-US/project/++[Fedora’s Mission and Foundations]
|
||||
|
||||
* link:++https://fedoraproject.org/wiki/FAQ++[Fedora FAQ]
|
||||
|
||||
* link:++https://fedoraproject.org/wiki/Communicate++[Help and Discussions]
|
||||
* link:++https://docs.fedoraproject.org/en-US/project/communications/++[Communication in Fedora]
|
||||
|
||||
* link:++https://fedoraproject.org/wiki/Join++[Participate in the Fedora Project]
|
||||
* link:++https://docs.fedoraproject.org/en-US/project/join/++[Get Involved in Fedora]
|
||||
|
||||
[[sect-need-help]]
|
||||
== Need Help?
|
||||
|
||||
There are a number of places you can get assistance should you run into problems.
|
||||
|
||||
If you run into a problem and would like some assistance, go to link:++https://ask.fedoraproject.org++[]. Many answers are already there, but if you don't find yours, you can simply post a new question. This has the advantage that anyone else with the same problem can find the answer, too.
|
||||
If you run into a problem and would like some assistance, go to link:++https://discussion.fedoraproject.org/c/ask/6++[Ask Fedora]. Many answers are already there, but if you don't find yours, you can simply post a new question. This has the advantage that anyone else with the same problem can find the answer, too.
|
||||
|
||||
You may also find assistance on the `#fedora` channel on the IRC network `irc.libera.chat`. Keep in mind that the channel is populated by volunteers wanting to help, but folks knowledgeable about a specific topic might not always be available.
|
||||
You may also find assistance in the `#fedora` room on link:++https://chat.fedoraproject.org/++[Fedora's Matrix instance]. Keep in mind that the room is populated by volunteers wanting to help, but folks knowledgeable about a specific topic might not always be available.
|
||||
|
||||
[[sect-providing-help]]
|
||||
== Want to Contribute?
|
||||
|
||||
You can help the Fedora Project community continue to improve Fedora if you file bug reports and enhancement requests. Refer to link:++https://fedoraproject.org/wiki/BugsAndFeatureRequests++[Bugs And Feature Requests] on the Fedora Wiki for more information about bug and feature reporting. Thank you for your participation.
|
||||
You can help the Fedora Project community continue to improve Fedora if you file bug reports and enhancement requests. Refer to link:++https://docs.fedoraproject.org/en-US/quick-docs/bugzilla-file-a-bug/++[How to file a bug] for more information about bug and feature reporting. Thank you for your participation.
|
||||
|
|
@ -1,6 +1,6 @@
|
|||
|
||||
:experimental:
|
||||
include::{partialsdir}/entities.adoc[]
|
||||
include::partial$entities.adoc[]
|
||||
|
||||
== We want feedback
|
||||
indexterm:[feedback,contact information for this manual]
|
||||
9
modules/release-notes/partials/entities.adoc
Normal file
9
modules/release-notes/partials/entities.adoc
Normal file
|
|
@ -0,0 +1,9 @@
|
|||
:BOOKID: release-notes
|
||||
:BZURL: https://gitlab.com/fedora/docs/fedora-linux-documentation/release-notes/-/issues
|
||||
// Change this to the latest version
|
||||
:COMMONBUGS_URL: https://discussion.fedoraproject.org/tags/c/ask/common-issues/82/all/f40
|
||||
:HOLDER: Fedora Project Contributors
|
||||
:PREVVER: 39
|
||||
:PRODUCT: Fedora Documentation
|
||||
:PRODVER: rawhide
|
||||
:YEAR: 2024
|
||||
181
scripts/gen_release_notes.py
Normal file
181
scripts/gen_release_notes.py
Normal file
|
|
@ -0,0 +1,181 @@
|
|||
#!/usr/bin/python3
|
||||
"""
|
||||
gen_release_notes.py
|
||||
|
||||
Retrieve release notes from the wiki, and generate
|
||||
release notes adoc file for each release notes category in
|
||||
modules/release-notes/pages/$category_name.adoc.
|
||||
|
||||
The generated category document is based on the matching
|
||||
template $category_name.adoc.j2 in the templates directory.
|
||||
If this template does not exists, it will use
|
||||
default_category.adoc.j2 instead.
|
||||
|
||||
Requires:
|
||||
python3-requests
|
||||
python3-jinja2
|
||||
|
||||
dnf install -y python3-requests python3-jinja2
|
||||
or
|
||||
pip install -r requirements.txt
|
||||
"""
|
||||
|
||||
import requests
|
||||
import sys
|
||||
import re
|
||||
import jinja2
|
||||
import logging
|
||||
import urllib.parse
|
||||
import os
|
||||
import argparse
|
||||
|
||||
api_url = "https://fedoraproject.org/w/api.php"
|
||||
|
||||
|
||||
def list_changes(release):
|
||||
"""
|
||||
Retrieve list of changes from ChangeAcceptedFxx wiki category
|
||||
returns a list of wiki pages:
|
||||
[{
|
||||
"pageid": 12345,
|
||||
"ns": 0,
|
||||
"title": "Changes/MyAwesomeChange"
|
||||
},...]
|
||||
"""
|
||||
params = {
|
||||
"action": "query",
|
||||
"list": "categorymembers",
|
||||
"cmtitle": f"Category:ChangeAcceptedF{release}",
|
||||
"cmlimit": 100,
|
||||
"format": "json",
|
||||
}
|
||||
s = requests.Session()
|
||||
req = s.get(url=api_url, params=params)
|
||||
if req.status_code != 200:
|
||||
logging.error(req.status_code)
|
||||
return []
|
||||
|
||||
data = req.json()
|
||||
return data["query"]["categorymembers"]
|
||||
|
||||
|
||||
def get_change_info(pageid):
|
||||
"""
|
||||
Get change release notes and categories from the wiki page
|
||||
returns a dict:
|
||||
{
|
||||
"title": MyAwesomeChange,
|
||||
"categories": ["SystemWideChange", "SomeOtherCategory"],
|
||||
"url": f"https://fedoraproject.org/wiki/Changes/MyAwesomeChange",
|
||||
"release_notes": "You are awesome!",
|
||||
}
|
||||
"""
|
||||
info = {}
|
||||
s = requests.Session()
|
||||
params = {
|
||||
"action": "parse",
|
||||
"pageid": pageid,
|
||||
"prop": "categories|sections",
|
||||
"format": "json",
|
||||
}
|
||||
req = s.get(url=api_url, params=params)
|
||||
page_data = req.json()
|
||||
rn_sid = None
|
||||
info = {
|
||||
"title": page["title"].replace("Changes/", ""),
|
||||
"categories": [],
|
||||
"url": f"https://fedoraproject.org/wiki/{urllib.parse.quote(page['title'])}",
|
||||
"release_notes": "",
|
||||
}
|
||||
|
||||
# Get categories
|
||||
for category in page_data["parse"]["categories"]:
|
||||
if category["*"].startswith("ChangeAccepted"):
|
||||
continue
|
||||
info["categories"].append(category["*"])
|
||||
|
||||
# Find release notes section
|
||||
for section in page_data["parse"]["sections"]:
|
||||
if section["line"] == "Release Notes":
|
||||
rn_sid = section["index"]
|
||||
break
|
||||
if rn_sid:
|
||||
# Fetch release notes text
|
||||
params = {
|
||||
"action": "parse",
|
||||
"pageid": page["pageid"],
|
||||
"section": rn_sid,
|
||||
"prop": "wikitext",
|
||||
"format": "json",
|
||||
}
|
||||
req = s.get(url=api_url, params=params)
|
||||
section_data = req.json()
|
||||
# Remove html comments and empty lines
|
||||
info["release_notes"] = "\n".join(
|
||||
re.sub(
|
||||
"<!--.*?-->",
|
||||
"",
|
||||
section_data["parse"]["wikitext"]["*"],
|
||||
flags=re.MULTILINE | re.DOTALL,
|
||||
).splitlines()[1::]
|
||||
).strip()
|
||||
|
||||
if not info["release_notes"]:
|
||||
# If no release notes, fallback to summary
|
||||
params = {
|
||||
"action": "parse",
|
||||
"pageid": page["pageid"],
|
||||
"section": 2, # I expect the summary to be always the first section (after the title) of the page
|
||||
"prop": "wikitext",
|
||||
"format": "json",
|
||||
}
|
||||
req = s.get(url=api_url, params=params)
|
||||
section_data = req.json()
|
||||
# Remove html comments and empty lines
|
||||
info["release_notes"] = "\n".join(
|
||||
re.sub(
|
||||
"<!--.*?-->",
|
||||
"",
|
||||
section_data["parse"]["wikitext"]["*"],
|
||||
flags=re.MULTILINE | re.DOTALL,
|
||||
).splitlines()[1::]
|
||||
).strip()
|
||||
|
||||
return info
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
logging.basicConfig(level=logging.INFO)
|
||||
abs_path = os.path.dirname(os.path.abspath(sys.argv[0]))
|
||||
rn_per_cats = {}
|
||||
parser = argparse.ArgumentParser(
|
||||
description="Generate release notes from the ChangeAccepted wiki category"
|
||||
)
|
||||
parser.add_argument("release", help="Fedora Linux version")
|
||||
args = parser.parse_args()
|
||||
env = jinja2.Environment(loader=jinja2.FileSystemLoader(f"{abs_path}/templates"))
|
||||
default_tpl = env.get_template("default_category.adoc.j2")
|
||||
|
||||
logging.info(f"Fetching changes for Fedora {args.release}...")
|
||||
for page in list_changes(args.release):
|
||||
change = get_change_info(page["pageid"])
|
||||
logging.info(f"Processed change {change['title']}...")
|
||||
for cat in change["categories"]:
|
||||
if cat not in rn_per_cats:
|
||||
rn_per_cats[cat] = []
|
||||
rn_per_cats[cat].append(change)
|
||||
|
||||
for cat_name, changes in rn_per_cats.items():
|
||||
logging.info(f"Generating {cat_name}.adoc...")
|
||||
if os.path.exists(f"{abs_path}/templates/{cat_name}.adoc.j2"):
|
||||
tpl = env.get_template(f"{cat_name}.adoc.j2")
|
||||
else:
|
||||
tpl = default_tpl
|
||||
output_from_parsed_template = tpl.render(cat_name=cat_name, changes=changes)
|
||||
|
||||
with open(
|
||||
f"{abs_path}/../modules/release-notes/pages/{cat_name}.adoc", "w"
|
||||
) as fh:
|
||||
fh.write(output_from_parsed_template)
|
||||
|
||||
logging.info("Completed.")
|
||||
2
scripts/requirements.txt
Normal file
2
scripts/requirements.txt
Normal file
|
|
@ -0,0 +1,2 @@
|
|||
Jinja2
|
||||
requests
|
||||
16
scripts/templates/SelfContainedChange.adoc.j2
Normal file
16
scripts/templates/SelfContainedChange.adoc.j2
Normal file
|
|
@ -0,0 +1,16 @@
|
|||
|
||||
include::{partialsdir}/entities.adoc[]
|
||||
|
||||
= Self-Contained Changes
|
||||
|
||||
A self-contained change is a change to isolated package(s), or a general change with limited scope and impact on the rest of the distribution/project.
|
||||
Examples include addition of a group of leaf packages, or a coordinated effort within a Special Interest Group (SIG) with limited impact outside the SIG’s functional area.
|
||||
|
||||
{% for change in changes %}
|
||||
== {{ change['title'] }}
|
||||
|
||||
{{ change['release_notes'] }}
|
||||
|
||||
__Read {{ change['url'] }}[more information] about this change.__
|
||||
|
||||
{% endfor %}
|
||||
13
scripts/templates/default_category.adoc.j2
Normal file
13
scripts/templates/default_category.adoc.j2
Normal file
|
|
@ -0,0 +1,13 @@
|
|||
|
||||
include::{partialsdir}/entities.adoc[]
|
||||
|
||||
= {{ cat_name }}
|
||||
|
||||
{% for change in changes %}
|
||||
== {{ change['title'] }}
|
||||
|
||||
{{ change['release_notes'] }}
|
||||
|
||||
__Read {{ change['url'] }}[more information] about this change.__
|
||||
|
||||
{% endfor %}
|
||||
2
site.yml
2
site.yml
|
|
@ -6,7 +6,7 @@ content:
|
|||
- url: .
|
||||
branches: HEAD
|
||||
- url: https://gitlab.com/fedora/docs/fedora-linux-documentation/release-docs-home.git
|
||||
branches: f37
|
||||
branches: main
|
||||
ui:
|
||||
bundle:
|
||||
url: https://gitlab.com/fedora/docs/docs-website/ui-bundle/-/jobs/artifacts/HEAD/raw/build/ui-bundle.zip?job=bundle-stable
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue