Multiple docs updates #10790

Merged
jnsamyak merged 5 commits from docs_updates into main 2026-06-08 03:11:10 +00:00
9 changed files with 130 additions and 33 deletions

View file

@ -0,0 +1,8 @@
div.document {
width: 70% !important;
max-width: 80% !important;
}
div.body {
max-width: none !important;
}

View file

@ -27,8 +27,8 @@ import os
#### BEGIN Fedora specific items
rst_epilog = """
.. |fedora-version| replace:: 22
.. |fedora-version-next| replace:: 23
.. |fedora-version| replace:: 36
.. |fedora-version-next| replace:: 37
"""
#### END Fedora specific items
@ -109,6 +109,7 @@ pygments_style = 'sphinx'
# The theme to use for HTML and HTML Help pages. See the documentation for
# a list of builtin themes.
html_css_files = ['custom.css',]
html_theme = 'alabaster'
# Theme options are theme-specific and customize the look and feel of a theme

View file

@ -15,7 +15,6 @@ this SOP.
The following freeze policies are set for the following significant release
milestones:
* `Alpha Freeze`_
* `String Freeze`_
* `Beta Freeze`_
* `Final Freeze`_
@ -51,7 +50,6 @@ Consider Before Running
`Freeze Exception Bug Process`
.. _Alpha Freeze: https://fedoraproject.org/wiki/Milestone_freezes
.. _Beta Freeze: https://fedoraproject.org/wiki/Milestone_freezes
.. _Final Freeze: https://fedoraproject.org/wiki/Milestone_freezes
.. _String Freeze: https://fedoraproject.org/wiki/Software_String_Freeze_Policy

View file

@ -567,6 +567,23 @@ We need to sync the signed checksums to /pub/alt/stage/ by running the following
$ for dir in Everything Cloud CloudImages Docker Labs Server Spins Workstation WorkstationOstree metadata; do sudo -u ftpsync rsync -avhH /mnt/koji/compose/26/Fedora-26-20170328.0/compose/$dir/ /pub/alt/stage/26_Alpha-1.4/$dir/ --link-dest=/pub/fedora/linux/development/26/Everything/ --link-dest=/pub/alt/stage/26_Alpha-1.1/Everything/ --link-dest=/pub/alt/stage/26_Alpha-1.2/Everything/ --link-dest=/pub/alt/stage/26_Alpha-1.3/Everything --link-dest=/pub/alt/stage/26_Alpha-1.4/Everything; done
Move development to release folder with mirrormanager
=====================================================
Two weeks after the release move bits from development to release directory
#. ssh to the mm-backend01.iad2.fedoraproject.org
::
$ ssh mm-backend01.iad2.fedoraproject.org
#. get root
::
$ sudo su
#. run the mm2_move-devel-to-release
::
$ mm2_move-devel-to-release --version=35 --category='Fedora Linux'
Consider before Running
=======================

View file

@ -447,6 +447,70 @@ Update eol wiki page
https://fedoraproject.org/wiki/End_of_life update with release and number of
days.
Move the EOL release to archive
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
#. log into to bodhi-backend01 and become root
::
$ ssh bodhi-backend01.iad2.fedoraproject.org
$ sudo su
$ su - ftpsync
#. then change into the releases directory.
::
$ cd /pub/fedora/linux/releases
#. check to see that the target directory doesnt already exist.
::
$ ls /pub/archive/fedora/linux/releases/
#. do a recursive rsync to update any changes in the trees since the previous copy.
::
$ rsync -avAXSHP ./35/ /pub/archive/fedora/linux/releases/35/
#. we now do the updates and updates/testing in similar ways.
::
$ cd ../updates/
$ rsync -avAXSHP 35/ /pub/archive/fedora/linux/updates/35/
$ cd testing
$ rsync -avAXSHP 35/ /pub/archive/fedora/linux/updates/testing/35/
#. do the same with fedora-secondary.
#. announce to the mirror list this has been done and that in 2 weeks you will move the old trees to archives.
#. in two weeks, log into mm-backend01 and run the archive script
::
$ sudo -u mirrormanager mm2_move-to-archive --originalCategory="Fedora Linux" --archiveCategory="Fedora Archive" --directoryRe='/35/Everything'
#. if there are problems, the postgres DB may have issues and so you need to get a DBA to update the backend to fix items.
#. wait an hour or so then you can remove the files from the main tree.
::
$ ssh bodhi-backend01
$ cd /pub/fedora/linux
$ cd releases/35
$ ls # make sure you have stuff here
$ rm -rf *
$ ln ../20/README .
$ cd ../../updates/35
$ ls #make sure you have stuff here
$ rm -rf *
$ ln ../20/README .
$ cd ../testing/35
$ ls # make sure you have stuff here
$ rm -rf *
$ ln ../20/README .
Consider Before Running

View file

@ -1,9 +1,9 @@
.. SPDX-License-Identifier: CC-BY-SA-3.0
==============
========================================
Fedora Media Writer Building and Signing
==============
========================================
Description
===========
@ -112,42 +112,43 @@ Sign and DMG
#. cd to the root directory of the FMW project
#. Run the following bash script:
::
#/bin/bash
::
security -v unlock-keychain login.keychain
#/bin/bash
# First sign all dynamic libraries (dylib's)
cd "build/app/Fedora Media Writer.app"
for dylib in $(find . -name "*dylib")
do
codesign -s "Developer ID Application: Fedora Gilmore" -v $dylib
done
# Now sign framework bundles
for framework in $(find . -name "*framework")
do
codesign -s "Developer ID Application: Fedora Gilmore" -v $framework
done
security -v unlock-keychain login.keychain
# Sign the two binaries
codesign -s "Developer ID Application: Fedora Gilmore" -v Contents/MacOS/helper
codesign -s "Developer ID Application: Fedora Gilmore" -v "Contents/MacOS/Fedora Media Writer"
# First sign all dynamic libraries (dylib's)
cd "build/app/Fedora Media Writer.app"
for dylib in $(find . -name "*dylib")
do
codesign -s "Developer ID Application: Fedora Gilmore" -v $dylib
done
# Now sign framework bundles
for framework in $(find . -name "*framework")
do
codesign -s "Developer ID Application: Fedora Gilmore" -v $framework
done
# Sign the app bundle
codesign -s "Developer ID Application: Fedora Gilmore" -v .
# Sign the two binaries
codesign -s "Developer ID Application: Fedora Gilmore" -v Contents/MacOS/helper
codesign -s "Developer ID Application: Fedora Gilmore" -v "Contents/MacOS/Fedora Media Writer"
# Create the dmg
cd ..
rm -f FedoraMediaWriter-osx-*.dmg
# Sign the app bundle
codesign -s "Developer ID Application: Fedora Gilmore" -v .
hdiutil create -srcfolder "Fedora Media Writer.app" -format UDCO -imagekey zlib-level=9 -scrub \
-volname FedoraMediaWriter-osx FedoraMediaWriter-osx-$(git describe --tags).dmg
# Create the dmg
cd ..
rm -f FedoraMediaWriter-osx-*.dmg
hdiutil create -srcfolder "Fedora Media Writer.app" -format UDCO -imagekey zlib-level=9 -scrub \
-volname FedoraMediaWriter-osx FedoraMediaWriter-osx-$(git describe --tags).dmg
Account Email(OS X)
-------------------
::
releng@fedoraproject.org
::
releng@fedoraproject.org
Account Holders(OS X)
---------------------

View file

@ -39,6 +39,7 @@ The mass rebuild depends on two main scripts from the `releng git repository`_.
* *massrebuildsinfo.py*
* module_mass_rebuild_epoch
* module_mass_rebuild_platform
Change the following items:
* the ``rebuildid`` to match the release for which you are mass rebuilding modules as per in massrebuildsinfo.py

View file

@ -28,6 +28,13 @@ Action
#. Sync the release to the Red Hat internal archive following internally documented
Check and set EOL on previous releases to reflect reality
=========================================================
#. check PDC for active releases and respective EOL date
#. if needed run the adjust-eol-all.py script from releng repository to correct any mistakes
Verification
============

View file

@ -107,7 +107,7 @@ Update Product Definition Center (PDC)
::
https://pdc.fedoraproject.org/rest_api/v1/component-branch-slas/?branch=TAG&global_component=PACKAGENAME
https://pdc.fedoraproject.org/rest_api/v1/component-branch-slas/?branch=TAG&global_component=PACKAGENAME
.. note::
If no information is returned by this query then it is not in PDC