Add a test for "index.md" frontmatter and fix the repo to match

[evankanderson]

Hugo expects page bundles to have an _index.md or index.md file, but GitHub expects README.md. Until gohugoio/hugo#4691 is fixed (still in flight, negotiating with hugo owner), it seems simplest to simply create index.md files for these leaf bundles with appropriate frontmatter and a {{% readfile file="README.md" %}} shortcode.

Proposed Changes

• Migrates frontmatter in about 50 directories into index.md files.
• Adds the _index.html frontpage that is in the website, so that we can eventually stop copying the file during website build.
• Adds a test to prevent backsliding

[evankanderson]

Here is a script which does not work for some cases which I used to start the conversion (just for reference):

#!/bin/bash

echo Working on $1

INDEX="${1%README.md}index.md"

awk '/^---/, /^$/' "$1" > "$INDEX"
echo '{{% readfile file="README.md" %}}' >> "$INDEX"

awk '/^---/, /^$/ {next}; {print}' "$1" > "$1.tmp" && mv "$1.tmp" "$1"

echo Wrote $INDEX and $1

[evankanderson]

Verified TestHugoBundles is run, will fix the markdown issue.

[evankanderson]

The test failure is fixed by knative/test-infra#1898

[evankanderson]

/retest pull-knative-docs-integration-tests

[evankanderson]

/hold

I just found some odd rendering that I need to investigate.

[evankanderson]

Example: https://docs-2377.default.docs-on-the-rocks.io/community/samples/serving/helloworld-haskell/ has lost the sidebar.

[evankanderson]

/hold cancel

[evankanderson]

/retest

[evankanderson]

The rendering works with knative/website#161 merged and applied on the website side.

I'll still need to update the other branches after this before we can drop the find -exec if ... ; then mv ..., but this gets us closer.

[abrennan89]

/lgtm

[knative-prow-robot]

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: abrennan89, evankanderson

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 [evankanderson]

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