Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Improve how documentation pages are rendered #1776

Merged
merged 1 commit into from
Nov 13, 2020

Conversation

nickcharlton
Copy link
Member

@nickcharlton nickcharlton commented Sep 21, 2020

Taking @EWright212's work from #1705, as I don't seem to be able to push to that branch.


  • Extracts an object to encapsulate rendering a given page (which also
    allows us to explicitly test it),
  • Allows us to render pages without the YAML frontmatter, which was
    making a mess of the README and Contributing Guide,

@nickcharlton nickcharlton added the documentation how to use administrate, examples and common usage label Oct 6, 2020
@nickcharlton nickcharlton force-pushed the nc-readme-as-docs-file branch from 33f7db9 to a4846fa Compare November 6, 2020 19:27
@nickcharlton nickcharlton changed the title Handle the README as a "special" docs file Improve how documentation pages are rendered Nov 6, 2020
@nickcharlton nickcharlton force-pushed the nc-readme-as-docs-file branch from a4846fa to 7c60246 Compare November 6, 2020 19:30
@nickcharlton
Copy link
Member Author

I ended up completely visiting this one, as I wasn't happy with the direction the DocsController was going in. We seemed to be going down a path which was just awkward (from how I'd explained how we might do this in the first place, to the implementation we had to ended up with because of it).

I also backfilled some feature specs here: I did this to drive me getting this working but maybe they could be better or just go.

@nickcharlton nickcharlton force-pushed the nc-readme-as-docs-file branch 3 times, most recently from 7b0f5f8 to 563995c Compare November 13, 2020 16:17
* Extracts an object to encapsulate rendering a given page (which also
  allows us to explicitly test it),
* Allows us to render pages without the YAML frontmatter, which was
  making a mess of the README and Contributing Guide.
@nickcharlton nickcharlton force-pushed the nc-readme-as-docs-file branch from 563995c to bc33fb5 Compare November 13, 2020 16:49
@nickcharlton
Copy link
Member Author

It turns out that the mysterious CI failure was related to case sensitive file systems: CI, being Linux, is case sensitive and so CONTRIBUTING and contributing aren't the same thing!

Finally, paired with @iftheshoefritz to go over this, so I'm going to merge this now!

@nickcharlton nickcharlton merged commit 0f8624c into master Nov 13, 2020
@nickcharlton nickcharlton deleted the nc-readme-as-docs-file branch November 13, 2020 18:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation how to use administrate, examples and common usage
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants