Add documentation for secret, configmap and downwardAPI file permissions for 1.4 release

[rata]

The patch that adds this feature in core kubernetes,
kubernetes/kubernetes#28936, was merged and will be
released with kubernetes 1.4.

---

This change is

[rata]

The test fail seems unrelated. It says: examples_test.go:293: ../docs/user-guide/sj.yaml: sj does not have a test case defined

[rata]

And this seems to be the fixed, so probably this will pass once this other PR is merged: #1159

[devin-donnelly]

Review status: 0 of 3 files reviewed at latest revision, 4 unresolved discussions.

---

docs/user-guide/configmap/index.md, line 417 [r1] (raw file):

Projections of keys to specific paths and file permissions

In general, prefer active to passive voice.

"Projecting keys to specific paths and file permissions"

---

docs/user-guide/configmap/index.md, line 419 [r1] (raw file):

#### Projections of keys to specific paths and file permissions

Projections of keys to specific paths and specific permissions per file are also

Same w/r/t active/passive voice.

"You can project keys to specific paths and specific permissions on a per-file basis. The Secrets user guide explains the syntax."

---

docs/user-guide/downward-api/index.md, line 117 [r1] (raw file):

In future, it will be possible to specify a specific annotation or label.

#### Projections of keys to specific paths and file permissions

"Projecting keys to specific paths and file permissions"

---

docs/user-guide/downward-api/index.md, line 119 [r1] (raw file):

#### Projections of keys to specific paths and file permissions

Projections of keys to specific paths and specific permissions per file are also

"You can project keys to specific paths and specific permissions on a per-file basis. The Secrets user guide explains the syntax."

---

Comments from Reviewable

[devin-donnelly]

Some minor wording changes; once cleaned up, I'll add Docs LGTM.

[rata]

Review status: 0 of 3 files reviewed at latest revision, 4 unresolved discussions.

---

docs/user-guide/configmap/index.md, line 417 [r1] (raw file):

Previously, devin-donnelly wrote…

In general, prefer active to passive voice.

"Projecting keys to specific paths and file permissions"

Fixed! :)

The title was based on this other from the "secrets" section: "Projection of secret keys to specific paths"

---

docs/user-guide/configmap/index.md, line 419 [r1] (raw file):

Previously, devin-donnelly wrote…

Same w/r/t active/passive voice.

"You can project keys to specific paths and specific permissions on a per-file basis. The Secrets user guide explains the syntax."

Fixed

---

docs/user-guide/downward-api/index.md, line 117 [r1] (raw file):

Previously, devin-donnelly wrote…

"Projecting keys to specific paths and file permissions"

Fixed!

---

docs/user-guide/downward-api/index.md, line 119 [r1] (raw file):

Previously, devin-donnelly wrote…

"You can project keys to specific paths and specific permissions on a per-file basis. The Secrets user guide explains the syntax."

Fixed!

---

Comments from Reviewable

[rata]

Thanks, I think I addressed them all. Please take another look :)

---

Review status: 0 of 3 files reviewed at latest revision, 4 unresolved discussions.

---

Comments from Reviewable

[devin-donnelly]

@rata , would you mind rebasing this PR on the latest from release-1.4? I'm testing some staging things.

[rata]

@devin-donnelly sure, np! Rebased now :)

[devin-donnelly]

Thanks! And Docs LGTM. Still going to hold for Tech Review; I'll flag it.

[rata]

@devin-donnelly thanks! I wrote the core kubernetes patch (kubernetes/kubernetes#28936) adding this functionality, so maybe there is no need to bother someone else for the tech review.

But I understand if someone from the kubernetes org needs to confirm. Just saying in case we can avoid @bgrant0607's time! :)

[devin-donnelly]

Oh, okay. No problem, then.