opendevreview | Ghanshyam proposed openstack/governance master: Adding TC chair election process https://review.opendev.org/c/openstack/governance/+/862772 | 03:47 |
---|---|---|
opendevreview | Ghanshyam proposed openstack/governance master: Adding TC chair election process https://review.opendev.org/c/openstack/governance/+/862772 | 03:47 |
opendevreview | Ghanshyam proposed openstack/governance master: Adding TC chair election process https://review.opendev.org/c/openstack/governance/+/862772 | 04:03 |
opendevreview | Ghanshyam proposed openstack/governance master: Adding TC chair election process: nomination in TC meeting https://review.opendev.org/c/openstack/governance/+/862774 | 04:07 |
opendevreview | Ghanshyam proposed openstack/governance master: Adding TC chair election process: nomination in governance repo https://review.opendev.org/c/openstack/governance/+/862772 | 04:07 |
*** yadnesh|away is now known as yadnesh | 04:07 | |
*** jpena|off is now known as jpena | 06:58 | |
*** yadnesh is now known as yadnesh|afk | 08:19 | |
*** yadnesh|afk is now known as yadnesh | 08:56 | |
*** pawelmarkowski1 is now known as pawelmarkowski | 10:12 | |
mkarpiarz | Hi. 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 |
mkarpiarz | I 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 |
frickler | mkarpiarz: 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-service | 11:56 |
*** yadnesh is now known as yadnesh|away | 12:53 | |
mkarpiarz | frickler: Thanks! I think we are getting there but are not there yet. :) | 13:11 |
mkarpiarz | Looks 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 |
mkarpiarz | However, it's not clear to me where the project slug (for example "accelerator" for Cyborg) comes from. | 13:14 |
mkarpiarz | Also, 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 |
mkarpiarz | So the question is now: how https://docs.openstack.org/zed/api/ is generated? | 13:15 |
mkarpiarz | Maybe 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 |
frickler | I think this is generated from data in https://opendev.org/openstack/openstack-manuals/src/branch/master/www/project-data/zed.yaml | 13:19 |
mkarpiarz | frickler: Looks like this is it! | 14:12 |
mkarpiarz | The 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 |
kayo | hello 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 |
frickler | mkarpiarz: 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 anyway | 14:46 |
mkarpiarz | Yep, 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 |
mkarpiarz | Thank you for pointing us in the right direction! | 14:53 |
opendevreview | Ghanshyam proposed openstack/governance master: Update CHAIR.rst for few updates https://review.opendev.org/c/openstack/governance/+/862637 | 15:57 |
*** jpena is now known as jpena|off | 16:32 |
Generated by irclog2html.py 2.17.3 by Marius Gedminas - find it at https://mg.pov.lt/irclog2html/!