Thursday, 2022-10-27

opendevreviewGhanshyam proposed openstack/governance master: Adding TC chair election process  https://review.opendev.org/c/openstack/governance/+/86277203:47
opendevreviewGhanshyam proposed openstack/governance master: Adding TC chair election process  https://review.opendev.org/c/openstack/governance/+/86277203:47
opendevreviewGhanshyam proposed openstack/governance master: Adding TC chair election process  https://review.opendev.org/c/openstack/governance/+/86277204:03
opendevreviewGhanshyam proposed openstack/governance master: Adding TC chair election process: nomination in TC meeting  https://review.opendev.org/c/openstack/governance/+/86277404:07
opendevreviewGhanshyam proposed openstack/governance master: Adding TC chair election process: nomination in governance repo  https://review.opendev.org/c/openstack/governance/+/86277204:07
*** yadnesh|away is now known as yadnesh04:07
*** jpena|off is now known as jpena06:58
*** yadnesh is now known as yadnesh|afk08:19
*** yadnesh|afk is now known as yadnesh08:56
*** pawelmarkowski1 is now known as pawelmarkowski10:12
mkarpiarzHi. Does anyone know how this page is generated https://docs.openstack.org/api-ref/ and how to add links to API references of other projects there?10:42
mkarpiarzI know this project allows to generate the actal references https://opendev.org/openstack/os-api-ref but I see nothing about links there.10:49
fricklermkarpiarz: if you are talking about a new openstack project to be added there, have a look at https://docs.openstack.org/doc-contrib-guide/api-guides.html#how-to-document-your-openstack-api-service11:56
*** yadnesh is now known as yadnesh|away12:53
mkarpiarzfrickler: Thanks! I think we are getting there but are not there yet. :)13:11
mkarpiarzLooks like the existence of a link in "api-ref" is somehow related to the "api-ref/source" directory in project's git repo.13:12
mkarpiarzHowever, it's not clear to me where the project slug (for example "accelerator" for Cyborg) comes from.13:14
mkarpiarzAlso, this page contains labels which don't appear in project repos: https://docs.openstack.org/zed/api/13:15
mkarpiarz(for example "Accelerator Life Cycle Management" for Cyborg)13:15
mkarpiarzSo the question is now: how https://docs.openstack.org/zed/api/ is generated?13:15
mkarpiarzMaybe I should ask one of the projects which have a link to their API reference/guide on https://docs.openstack.org/zed/api/?13:18
fricklerI think this is generated from data in https://opendev.org/openstack/openstack-manuals/src/branch/master/www/project-data/zed.yaml13:19
mkarpiarzfrickler: Looks like this is it!14:12
mkarpiarzThe project I want to add to the landing page (CloudKitty) is in this YAML but doesn't have the "has_config_ref" parameter set.14:13
mkarpiarz*"has_api_ref"14:13
kayohello team, if I want to start coding around openstack where is the best place or project to start? and do we have a tag like 'easy hacks' for starters like me?14:21
fricklermkarpiarz: well the first steps would all need to happen within the cloudkitty repo, adding source and config for generating the api-ref documents. before that is done, there is nothing you could publish anyway14:46
mkarpiarzYep, that's exactly the plan. API docs are in the repo, just in a wrong place, so we will work on moving them to the "api-ref" directory and go from there.14:52
mkarpiarzThank you for pointing us in the right direction!14:53
opendevreviewGhanshyam proposed openstack/governance master: Update CHAIR.rst for few updates  https://review.opendev.org/c/openstack/governance/+/86263715:57
*** jpena is now known as jpena|off16:32

Generated by irclog2html.py 2.17.3 by Marius Gedminas - find it at https://mg.pov.lt/irclog2html/!