Fix Jekyll Routing

[ajschmidt8]

NOTE: These changes are necessary for #541. They are included in that PR. This PR is not meant to be merged, it only exists so that these individual changes can be viewed separately from #541.

This PR fixes some routing issues with our site. The issue stems from using the permalink property on certain pages. Using permalink causes the generated HTML output to differ from pages that don't use it.

For example, when the api.md page uses permalink: api, the generated HTML output looks like this:

dist/
└── api.html

This causes the final webpage to be available at https://docs.rapids.ai/api (note the missing trailing slash at the end of the URL).

Compare that to the HTML output of pages that don't use the permalink property, like resources/auto-merger.md:

dist/resources/
└── auto-merger
    └── index.html

The difference is that the output file is named index.html and placed in a directory called auto-merger. Webservers handle directories with index.html differently. Therefore, the above page is served at https://docs.rapids.ai/resources/auto-merger/ (note the trailing slash at the end of the URL).

To make all of our paths consistent (which is necessary for #541), this PR removes all permalink property usage and moves the affected files to the appropriate directory with a new index.md name.

It also updates any references to the affected files.

[netlify]

✅ Deploy Preview for docs-rapids-ai ready!

Name	Link
🔨 Latest commit	698c99a
🔍 Latest deploy log	https://app.netlify.com/sites/docs-rapids-ai/deploys/66edafce584dd6000802e694
😎 Deploy Preview	https://deploy-preview-542--docs-rapids-ai.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify site configuration.

[ajschmidt8]

Here's a list of all the pages that had their permalink property removed:

• Deploy preview:

  • https://deploy-preview-542--docs-rapids-ai.netlify.app/
  • https://deploy-preview-542--docs-rapids-ai.netlify.app/api/
  • https://deploy-preview-542--docs-rapids-ai.netlify.app/contributing/
  • https://deploy-preview-542--docs-rapids-ai.netlify.app/install/
  • https://deploy-preview-542--docs-rapids-ai.netlify.app/maintainers/
  • https://deploy-preview-542--docs-rapids-ai.netlify.app/notices/
  • https://deploy-preview-542--docs-rapids-ai.netlify.app/notices/rdn/
  • https://deploy-preview-542--docs-rapids-ai.netlify.app/notices/rgn/
  • https://deploy-preview-542--docs-rapids-ai.netlify.app/notices/rsn/
  • https://deploy-preview-542--docs-rapids-ai.netlify.app/releases/
  • https://deploy-preview-542--docs-rapids-ai.netlify.app/resources/
  • https://deploy-preview-542--docs-rapids-ai.netlify.app/user-guide/
  • https://deploy-preview-542--docs-rapids-ai.netlify.app/visualization/

• Live site:

  • https://docs.rapids.ai/
  • https://docs.rapids.ai/api
  • https://docs.rapids.ai/contributing
  • https://docs.rapids.ai/install
  • https://docs.rapids.ai/maintainers
  • https://docs.rapids.ai/notices
  • https://docs.rapids.ai/notices/rdn
  • https://docs.rapids.ai/notices/rgn
  • https://docs.rapids.ai/notices/rsn
  • https://docs.rapids.ai/releases
  • https://docs.rapids.ai/resources
  • https://docs.rapids.ai/user-guide
  • https://docs.rapids.ai/visualization

[ajschmidt8]

superseded by #543