document Client CLI kn domain

[csantanapr]

The new version of the kn CLI container a new command domain

The info is included in the release notes but it should properly be documented in the website

It was suggested by @abrennan89 to open an issue in the PR for the release notes blod here

@csantanapr can you please open a docs issue for kn domain to get it properly documented in the site so it's not only explained here?

/assign @rhuss

[rhuss]

Is this something I could actively drive or is it more about delivering input for the documentation and the docs creation happens by somebody else ?

Happy to do either, if I know where to put this documentation to.

[abrennan89]

Note to self: Related to knative/ux#39

[abrennan89]

@rhuss either is fine - do you have draft info for docs for this, or want to take this issue and add a PR yourself?

[rhuss]

Let me pick this issue and write a documentation PR.

[snneji]

/priority high

[abrennan89]

Bump @rhuss - any progress on this one? Thanks!

[rhuss]

@abrennan89 thanks for the reminder. I know you will be angry with me 🙇 :) , but could you give me a quick pointer where to add the PR for the documentation ? (I mean to which file) . Thanks and apologies to bug you with this question, but the location is probably not https://knative.dev/docs/client/ ?

[abrennan89]

lol I'm not angry, don't worry 😄 thanks for getting back to me!
I would be inclined to say https://knative.dev/docs/developer/serving/services/custom-domains/ since you're right, there's not really a client reference guide so to speak, we tend to just add kn commands where they fit in procedures. Feel free to ping me on Slack if you need any additional help.

[rhuss]

@abrennan89 to which source file does https://knative.dev/docs/developer/serving/services/custom-domains/ translate ? I can't find it in the docs repo. There I only can find https://github.com/knative/docs/blob/mkdocs/docs/serving/using-a-custom-domain.md which is a completely different document.

[abrennan89]

@rhuss are you sure you're on the correct branch in git and that you have pulled / rebased any changes from upstream? I just checked on my local repo and it's definitely under docs/docs/developer/serving/services/custom-domains.md

[rhuss]

Thanks !

I was on the main branch (which does not contain that file), but it looks like that mkdocs is the default branch in the docs repo. Is there a particular reason why the main branch is not used as default, like for the others Knative repos ?

[abrennan89]

It's because it just hasn't been moved over yet, the plan was to use mkdocs temporarily.
@omerbensaadon any plans to move us back to the main branch?