Short aliases for security content

[jimangel]

Hey @sethmccombs @pbnj 👋 (and security sig-docs group).

I'm opening this issue to track a change I made in #18834 with hopes to improve / simplify security related content. If this is something you'd like to further explore, you can feel free to use this issue to track.

Otherwise, you can also feel free to close this and we will have this as historical reference to the chance / thought behind it.

More context if needed: https://youtu.be/DRNJ4KddfPI?t=1155

[zacharysarah]

Heads up that #19068 is relevant to this discussion.

[jimangel]

Also adding in #19077 - the TL;DR is:

aliases: [../../../rbac/]

for front matter.

[jimangel]

/assign @sethmccombs
/assign @pbnj

[k8s-ci-robot]

@jimangel: GitHub didn't allow me to assign the following users: pbnj.

Note that only kubernetes members, repo collaborators and people who have commented on this issue/PR can be assigned. Additionally, issues/PRs can only have 10 assignees at the same time.
For more information please see the contributor guide

In response to this:

/assign @sethmccombs
/assign @pbnj

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes/test-infra repository.

[zacharysarah]

See #19077 for how to structure aliases

[pbnj]

@jimangel - I love the idea of tracking alias in the respective pages' front-matter. I recall trying to visit something similar (k8s.io/psp IIRC) previously. Should I go ahead an send in a patch for that?

Thanks for the heads up. I have added it to the agenda for our upcoming sig-docs-security this Thursday, 02/20/2020

[jimangel]

@jimangel - I love the idea of tracking alias in the respective pages' front-matter. I recall trying to visit something similar (k8s.io/psp IIRC) previously. Should I go ahead an send in a patch for that?

Yes! Go ahead and open up the PR, ping me if you need an extra set of eyes for review.

[jimangel]

Closing with no clear path of what "resolved" looks like. I still support the general idea.

/close

[k8s-ci-robot]

@jimangel: Closing this issue.

In response to this:

Closing with no clear path of what "resolved" looks like. I still support the general idea.

/close

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes/test-infra repository.