okd-project / planning Goto Github PK

Update npm and pip dependencies and Docker container versions used to build okd.io site

Investigate the option of switching to the RedHat CRC release to deploy CRC on OKD and then pdate OKD.io site

https://fedora-messaging.readthedocs.io/en/latest/#user-guide

• Reach out to Neal Gompa
• Public facing url amqps://rabbitmq.fedoraproject.org/%2Fpublic_pubsub

Which section(s) is the issue in?

Understanding upgrade channels and generally the Updating clusters section
What needs fixing?

The docs nees to be updated to explain OKD only has a single update channel and fixes aren't back ported to previous minor releases. The docs are the OCP docs, where OCP has multiple release channels
openshift/openshift-docs#53296

Product docs PR openshift/openshift-docs#58413

Create a virtual event to populate an OKD operator catalog

Investigate permissions and document process on okd.io

We need a process to 'archive' older versions of the documentation. There is a need to keep 3.11 as there are community members with 3.11 estate that is in plan to get upgraded. We also need to look at older 4.x versions too

The okd repo has now been migrated from openshift to okd-project repo. Need to update the docs to point to the new location

Write up process for Single Node OKD (SNO) using self-hosted assisted installer

Reference guide : https://hackmd.io/tDnHM2BoQru0VgqMGI_Q5g
Linked discussion : okd-project/okd#1235

After the guide is created #27 should take the content and create docs.okd.io content

a OKD version of https://kubernetes.io/docs/concepts/overview/what-is-kubernetes/ for use on okd.io and in getting started guide

The 2022 survey is here...

https://docs.google.com/spreadsheets/d/1V4OKSqx__-AL3BrlHfUOoXyPSDHwFqG90tOgbjjXZo0/edit?usp=sharing

openshift/openshift-docs#51152

The OKD end user docs have instructions for Installing "OpenShift on a single node" that is OCP-specific.

It needs to be significantly rewritten:

• users will need to use installer from github releases instead of mirror.openshift.com
• references to console.redhat.com need to be replaced with selfhosted assisted installer

The files are to be hidden on OKD docs until we can make these changes.

Assemblies:
installing/installing_sno/install-sno-preparing-to-install-sno.adoc
installing/installing_sno/install-sno-installing-sno.adoc

How can a member of the community create a PR, verify it is a valid PR (page builds) - openshift docs

This is installing a SNO OKD cluster the "hard way" using UPI (user provisioned infrastructure)

Details for editing website: https://www.okd.io/wg_docs/okd-io/

Current link to google doc https://docs.google.com/document/d/19QjzNBDRgNiTk-LGki_xpi-lv8i_LRgf3dpOHSQ-_YI/edit

Please ping me for access

Create a blog post detailing the current OKD roadmap. This should be based on the recent OKD roadmap sessions at Valencia, Dublin and London:

https://www.youtube.com/watch?v=TgYCUM5KZ24
Dublin video? - can't find!
https://www.youtube.com/watch?v=rKyaKEgGW6Q

Discussion thread to gather results and comments on available refults is here

create email capability for OKD community

Investigate Tekton and Cluster Logging Operators in terms of build, documentation, and deployment.

Investigate adding a blogging plugin to the old.io site to automate the management of blogs within the site. The package https://pypi.org/project/mkdocs-blogging-plugin/ looks like a good candidate

The okd.io home page needs to be redesigned.

Discussion thread to gather community feedback : okd-project/okd#1365

Define an entry point for beginners

This topic being discussed : okd-project/okd#1286

Provide a series of videos which outline the foundations of OKD to be used towards general education and helping to build community support. Targeting September for completion.

• Ignition and Butane (~15 min) ✔️
  • Timothée: https://siosm.fedorapeople.org/2023%20OKD%20Foundations%20Video%20Series%20-%20Ignition%20and%20Butane.pdf
• FCOS (~15 min) ✔️
  • Timothée: https://siosm.fedorapeople.org/2023%20OKD%20Foundations%20Video%20Series%20-%20Fedora%20CoreOS.pdf
• OKD on FCOS Build Modifications
  • Christian
• OKD on SCOS Build ✔️
  • Alessandro, Christian, Sherine, Timothée: https://www.youtube.com/watch?v=1ShlFI2sftA
• Installation Options (including ABI)
  • Andrea Fasano
• MCO
  • TBD
• Deciphering Must Gather
  • Elmiko
• Troubleshooting Essentials
  • Jaime, Elmiko, Bruce

Move the home lab content to blogs then create a section or page with links to home labs content

Migrate okd main reposiotry from the OpenShift github org to okd-project org. There are no dependencies, so this can be moved at any time.

Create the Survey for 2024. The previous survey can be used as a starting point. Add any questions and suggestions below.

https://docs.google.com/document/d/1RtsoR1vi7PNHtG4ssAFsErvPO38K6u66KqyXBc5XD9E/edit?usp=sharing

contacts in the link

from the technical meeting. Introduce OKD feature toggle functionality

• request for use cases

There is also a possible option to allow tech preview with upgrade, normally enabling tech preview disables upgrades

create a video where we show how to take a failure and triage/debug back to the test. to share with the community how we try to chase down these bugs (elmiko, Bruce Link with Diane M)

Review survey responses to see if there are any actions we should take from the feedback

Outline the process, then document it in the docs

The following folks have voiced an interest in volunteering:

• Duanne ([email protected])

Migrate okd-io repo to okd-project org. This needs to be coordinated with the RedHat DNS team to migrate the okd.io URL to the new pages repo.

Next survey is being constructed here...

https://docs.google.com/forms/d/e/1FAIpQLScw5Qbt-iMorF4LdqzgwGY84eplmfGVq0xmN-LVrNv16g-2aA/viewform?usp=sf_link