Refresh Documentation Main Page

[tdcox]

Signed-off-by: Terry Cox terry@bootstrap.je

Changes

• Implemented a descriptive landing page for the documentation, with context and description
• Added icons to docs
• Disabled auto-generated page list

PR is 'look and feel' only and does not impact specification content.

Submitter Checklist

As the author of this PR, please check off the items in this checklist:

• Has the primer doc been updated if a design decision is involved
• Have the JSON schemas been updated if the specification changed
• Has spec version and event versions been updated according to the versioning policy
• Meets the CDEvents contributor standards

[e-backmark-ericsson]

I like that introductory text is added to the index page

[afrittoli]

Preview https://deploy-preview-24--cdevents.netlify.app/docs/
PR: cdevents/cdevents.dev#24

[afrittoli]

Thank you for this, it looks really good.
Only a couple of comments.
For TOCs we should use the existing tool.

[afrittoli]

Note: the requirement for approval on GitHub actions is only for first-time contributors, so once this is merged tests should run automatically on your PR 🙏

[tdcox]

@afrittoli Looks like it is stuck because the first commits weren't getting cryptographically signed. Can you override, or should I create a new PR?

[afrittoli]

@afrittoli Looks like it is stuck because the first commits weren't getting cryptographically signed. Can you override, or should I create a new PR?

I can override if you prefer.

You would not need to create a new PR to fix the issue, though, you could sign your past commits or since they need to be squashed anyways, you could squash them locally, sign your commit and push:

# Rebase the last 5 commits, mark all commits but one with "s" for squash
git rebase -i HEAD~5
# Sign the resulting commit
git commit -s --amend
# Push to your PR branch
git push <your-remote-name> refresh-1b --force

Let me know if you want to try that or if you prefer I merge right away 🙏

[tdcox]

@afrittoli Cleaned up...

[afrittoli]

Thank you for the updates.