| Posted | Nick | Remark | |
|---|---|---|---|
| #openstack-cyborg - 2026-08-04 | |||
| 14:30:53 | rlandy | the final place would be the admin docs? | |
| 14:31:09 | sean-k-mooney | i think so | |
| 14:31:11 | rlandy | ok | |
| 14:31:22 | rlandy | next ... | |
| 14:31:22 | sean-k-mooney | refence is not realy something we expect peole to read on a first reading of the doc | |
| 14:31:31 | sean-k-mooney | its more a place we keep technial notes | |
| 14:31:44 | sean-k-mooney | so puting it in the main admin guide will make this much more visable | |
| 14:31:46 | rlandy | https://review.opendev.org/c/openstack/cyborg/+/999278 | |
| 14:31:48 | sean-k-mooney | https://storage.gra.cloud.ovh.net/v1/AUTH_dcaab5e32b234d56b626f72581e3644c/zuul_opendev_logs_805/openstack/8055e6a20e464edcbb23ba49701ca037/docs/reference/support-matrix.html | |
| 14:31:54 | sean-k-mooney | is what it looks liek for now | |
| 14:32:03 | sean-k-mooney | i woudl add a docs colume as well | |
| 14:32:24 | sean-k-mooney | and maybe make status the last of the colums | |
| 14:32:46 | sean-k-mooney | so name, description, testing, docs, status | |
| 14:33:03 | rlandy | ok | |
| 14:33:18 | rlandy | doc will be blank until we have them all? | |
| 14:33:42 | sean-k-mooney | well you can set it to missing for most of the driver and partial for the intel driver | |
| 14:33:47 | sean-k-mooney | *for the pci driver | |
| 14:34:02 | sean-k-mooney | or partial for all | |
| 14:34:03 | rlandy | ok | |
| 14:34:17 | rlandy | partial sounds better | |
| 14:34:20 | sean-k-mooney | we have some basic configuration docs but they are not complete | |
| 14:34:35 | sean-k-mooney | https://storage.gra.cloud.ovh.net/v1/AUTH_dcaab5e32b234d56b626f72581e3644c/zuul_opendev_logs_805/openstack/8055e6a20e464edcbb23ba49701ca037/docs/configuration/drivers.html | |
| 14:34:40 | rlandy | I'll see what I can find to link | |
| 14:35:04 | sean-k-mooney | once we have per driver docs split out into there own page we can update the docs value in the new table | |
| 14:35:06 | rlandy | moving on to https://review.opendev.org/c/openstack/cyborg/+/999278 | |
| 14:35:19 | rlandy | ^^ remove the inling? | |
| 14:35:43 | rlandy | it seems like the reviewers want the separate doc back? | |
| 14:35:55 | sean-k-mooney | ya i think that should its own docuemnt not inline in the index as its a bit log | |
| 14:36:10 | sean-k-mooney | yes i think https://review.opendev.org/c/openstack/cyborg/+/999278/3/doc/source/user/using-cyborg.rst | |
| 14:36:20 | sean-k-mooney | was fine as it was that was not one of the docs i asked to be inlined | |
| 14:36:40 | rlandy | ok - will correct that | |
| 14:36:51 | rlandy | and also there was a note to move that? | |
| 14:36:54 | sean-k-mooney | however i think you can move https://docs.openstack.org/cyborg/latest/admin/#user-requests into that doc as well | |
| 14:37:20 | sean-k-mooney | so its a little bit tricky | |
| 14:37:30 | sean-k-mooney | normally the user docs are for end users | |
| 14:37:42 | rlandy | that doc - being using-cyborg? | |
| 14:37:48 | sean-k-mooney | so some one creatign a vm with cybrog fits into that catagory | |
| 14:37:57 | sean-k-mooney | yes | |
| 14:38:20 | sean-k-mooney | but the admin guide currently has admin/#user-requests | |
| 14:38:23 | rlandy | ok - let me rework those patches | |
| 14:38:25 | rlandy | thank you | |
| 14:38:27 | sean-k-mooney | and that feels like its in teh wron gplace | |
| 14:39:03 | rlandy | ok - any more doc comments? | |
| 14:39:17 | sean-k-mooney | the admin guide is ment to focus on thinks like configureing the service or creating flavors/device profiels for folkd to use it | |
| 14:40:00 | sean-k-mooney | melwitt: you wote some good developer focused docs for the neutron port workflow | |
| 14:40:31 | sean-k-mooney | melwitt: if we were to also docuemnt that more would you put it with the enduser docs | |
| 14:40:39 | sean-k-mooney | admin or both | |
| 14:41:23 | sean-k-mooney | i feel like procedure like htat woudl fit better in the enduser docs right? im just tryign to validate the recomemndation above | |
| 14:41:34 | sean-k-mooney | to have the creating an instance doc in the user docs not the admin docs | |
| 14:41:51 | melwitt | yeah to me admin guide is for admin-only actions or APIs | |
| 14:42:16 | sean-k-mooney | so disabling a deployable woudl go in admin docs | |
| 14:42:19 | melwitt | like setting up a cloud or configuring one | |
| 14:42:36 | sean-k-mooney | like disablign a nova compute service | |
| 14:42:49 | melwitt | yeah exactly | |
| 14:43:18 | sean-k-mooney | rlandy: ok i guess we shoudl keep an eye out for that split as we rework the exsting docs | |
| 14:43:33 | rlandy | there are a lot of moving parts | |
| 14:43:35 | melwitt | if the how-to is about cloud maintenance like disabling a service, that feels like admin guide to me | |
| 14:43:41 | rlandy | so I think we should do this in pieces | |
| 14:43:53 | rlandy | let's get in some basic changes | |
| 14:44:06 | rlandy | then reconsider more reorgs | |
| 14:44:16 | rlandy | unless we have a clear plan now | |
| 14:44:26 | rlandy | which may not be the case as there is a lot in development | |
| 14:44:39 | rlandy | my initial goal was to reorg the sections | |
| 14:45:00 | rlandy | so that engineers writing new docs could have a clean and organized place to work | |
| 14:45:12 | sean-k-mooney | ya so form the patches you have in flight you can restore the using cybrog to create an instance back to the user guide | |
| 14:45:16 | rlandy | but I don't know if we are ready for that | |
| 14:45:34 | sean-k-mooney | well the over all doc stucre is largely already coorrect | |
| 14:45:51 | rlandy | I am happy to work on this more as the development settles | |
| 14:46:01 | sean-k-mooney | there are some placeholder docs to remove and some minore refienment but most docs wont need to move | |
| 14:46:06 | melwitt | the usual split or sections is admin guide, user guide, contributor guide | |
| 14:46:11 | rlandy | ok - I can deal with those | |
| 14:46:30 | sean-k-mooney | yep and install guide which we alwasy forget about | |
| 14:47:33 | melwitt | it's kind of like personas I guess, organize docs per "persona" of someone who is working with cyborg. and then the install and reference sort of sections | |
| 14:47:57 | sean-k-mooney | yep | |
| 14:48:06 | melwitt | and overview/architecture section for learning | |
| 14:49:26 | rlandy | ok - I'll rework what I have and then look at a new structure | |
| 14:49:44 | rlandy | jgilaber: that is all I had - thank you | |
| 14:49:49 | rlandy | we can move on | |
| 14:50:23 | jgilaber | thanks rlandy moving on | |
| 14:50:36 | jgilaber | we don't have any new bugs | |
| 14:50:51 | jgilaber | any last minute topics for open discussion? | |
| 14:53:04 | jgilaber | #topic Volunteers to chair next meeting | |
| 14:53:12 | jgilaber | any volunteers for next meeting? | |
| 14:54:40 | rlandy | I can | |
| 14:54:48 | jgilaber | thanks rlandy | |
| 14:54:59 | jgilaber | that is all for today, thanks all | |
| 14:55:01 | jgilaber | #endmeeting | |
| 14:55:01 | opendevmeet | Meeting ended Tue Aug 4 14:55:01 2026 UTC. Information about MeetBot at http://wiki.debian.org/MeetBot . (v 0.1.4) | |
| 14:55:01 | opendevmeet | Minutes: https://meetings.opendev.org/meetings/cyborg/2026/cyborg.2026-08-04-14.03.html | |
| 14:55:01 | opendevmeet | Minutes (text): https://meetings.opendev.org/meetings/cyborg/2026/cyborg.2026-08-04-14.03.txt | |
| 14:55:01 | opendevmeet | Log: https://meetings.opendev.org/meetings/cyborg/2026/cyborg.2026-08-04-14.03.log.html | |
| 16:14:09 | opendevreview | Joan Gilabert proposed openstack/cyborg master: Enable database migration tests with mysql https://review.opendev.org/c/openstack/cyborg/+/997979 | |
| 16:14:10 | opendevreview | Joan Gilabert proposed openstack/cyborg master: Add MDEV and PCI device type constants https://review.opendev.org/c/openstack/cyborg/+/997047 | |
| 16:14:10 | opendevreview | Joan Gilabert proposed openstack/cyborg master: Add MdevBusManager for mdev bus discovery https://review.opendev.org/c/openstack/cyborg/+/997048 | |
| 16:14:11 | opendevreview | Joan Gilabert proposed openstack/cyborg master: Add [mdev] configuration section https://review.opendev.org/c/openstack/cyborg/+/997049 | |
| 16:14:11 | opendevreview | Joan Gilabert proposed openstack/cyborg master: Add generic mdev driver https://review.opendev.org/c/openstack/cyborg/+/997050 | |
| 16:14:12 | opendevreview | Joan Gilabert proposed openstack/cyborg master: Add duplicate device warning in conductor https://review.opendev.org/c/openstack/cyborg/+/997051 | |
| 16:14:12 | opendevreview | Joan Gilabert proposed openstack/cyborg master: Refactor GPU driver to use MdevBusManager https://review.opendev.org/c/openstack/cyborg/+/997052 | |
| 16:14:13 | opendevreview | Joan Gilabert proposed openstack/cyborg master: Add generic mdev driver documentation https://review.opendev.org/c/openstack/cyborg/+/997053 | |
| 16:14:13 | opendevreview | Joan Gilabert proposed openstack/cyborg master: Add per-PF vf_personality sysfs interface https://review.opendev.org/c/openstack/cyborg/+/998603 | |