| cardoe | Can we get the DNS entry osh.openstack.org reserved? The OpenStack Helm project is going to make some CRDs for Kubernetes and we figured we should scope to a domain that won’t be used for anything else. | 00:12 |
|---|---|---|
| fungi | cardoe: they have to be served at the root of a domain, can't go on tarballs or docs in a longer path? also do you have a feel for what the publication automation would be for it? is the content going to be generated by zuul jobs and then promoted to publication? | 13:05 |
| cardoe | There's nothing going to be served. | 13:50 |
| cardoe | I'll use External Secrets as an example.. | 13:51 |
| cardoe | apiVersion: external-secrets.io/v1 | 13:51 |
| cardoe | kind: ExternalSecret | 13:51 |
| cardoe | That's the first two lines in a k8s manifest. | 13:51 |
| cardoe | We're going to create some Custom Resource Definitions in the OpenStack Helm project. They've got to have "apiVersion". So we're proposing to use "osh.openstack.org/v1alpha1". So I'm just saying we should likely flag that. | 13:53 |
| cardoe | Personally anytime I've written a CRD, I've make the apiVersion string a real DNS entry and I've made the thing work like a real URL and redirect to the documentation. | 13:53 |
| fungi | ah, once upon a time we had project-specific subdomains for their "developer docs" (what the docs team at the time called documentation written by the developers rather than openstack's professional technical writers) | 13:55 |
| fungi | we still have those dns names maintained as redirects like https://nova.openstack.org/ for backward-compatibility with very old url references | 13:55 |
| fungi | we weren't ever planning to add new ones, but maybe this is a case that would warrant it | 13:56 |
| cardoe | It doesn't need to be a registered DNS entry. It's just ensuring uniqueness. I was just suggesting we register it. | 14:41 |
| fungi | yeah i think we're on the same page now | 14:43 |
| fungi | i would probably lean toward adding it to dns and setting up a web redirect to the osh docs at that name for transparency and to make sure nothing else ends up using it (not that it's a huge risk) | 14:44 |
| cardoe | That's what I've personally done for my CRDs just for that same reason. | 15:15 |
| opendevreview | Thales Elero Cervi proposed openstack/project-config master: Add repo app-prometheus to StarlingX https://review.opendev.org/c/openstack/project-config/+/982495 | 19:49 |
Generated by irclog2html.py 4.1.0 by Marius Gedminas - find it at https://mg.pov.lt/irclog2html/!