Remove "design docs" from /docs/reference sidebar

[ahmetb]

This list on the sidebar isn't very useful:

• it's not an exhaustive list
• it's not an up-to-date list either
• design docs are not documentation (they're already stale)
• we already link to the full list from https://kubernetes.io/docs/reference/
  home page

---

This change is 

[k8sio-netlify-preview-bot]

Deploy preview for kubernetes-io-master-staging ready!

Built with commit 3d38581

https://deploy-preview-6410--kubernetes-io-master-staging.netlify.com

[tengqm]

You will need to add docs/admin/ovs-networking.md to the skip_toc_check.txt file to make travis happy.

[ahmetb]

@tengqm is that fixed in a separate PR? If so I can just rebase my commit to make Travis happy.

[tengqm]

@ahmetb I'm afraid not. You may want to do it in your PR because it is your PR that makes it a dangling file . :)

[ahmetb]

@thockin I am about to remove ovs-networking.md completely, as part of removing links to design docs from k8s.io/docs/reference.

Do you think we should keep it somewhere else (like contrib/design-docs)? It seems untouched for about ~2 years, but if it is valuable information I can move it somewhere else.

[heckj]

@ahmetb Do you want to rebase this and remove the file that you commented on to @thockin and get this rolling again? I think the ToC checks in CI are the only real pending point... branch isn't set to updatable by a maintainer, or I might have just taken a stab at the rebase myself

[heckj]

/assign

[ahmetb]

I just don't know what to do with that ovs-networking.md file. 😟 I have no good place for it to move to. I also cannot assess if it contains information that deserve to be on the website, or should it just be deleted forever. Any ideas?

[heckj]

It's not invalid content - added two years ago and hasn't been touched since (in any real sense anyway), it only seems relevant to be a component of a "how to make your own bare-metal cluster from scratch" kind of reference effort. Kubernetes-the-hard-way is the most relevant track there- as official documentation goes, this isn't entirely helpful because it's so skimpy on end-to-end details, so I'd lean towards dropping it.

[ahmetb]

Deleted the ovs-networking.md and pushed again. PTAL.

[heckj]

@ahmetb the CI system is reporting:

Error: docs/reference/design-docs/overview.md doesn't have an entry in the table of contents under _data/*.yml
Found 1 files without entries. For how to fix it, see http://kubernetes.io/docs/home/contribute/write-new-topic/#creating-an-entry-in-the-table-of-contents

[heckj]

/approve
/lgtm

[k8s-ci-robot]

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: heckj

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

• OWNERS [heckj]

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment