apostrophecms / apostrophecms/apostrophe

Make the blog module easier to understand for new devs or document it better

Open
#986 1 comment 3 reactions 1 assignee Claimed by @bobclewell View on GitHub
documentation
Dominant language
JavaScript
Stars
4.6k
Forks
650
Avg merge
19h 21m
Merged PRs (30d)
23

Description

An onboarding problem with the blog module:

Currently there is no `body` schema field for a blog post, because we are assuming people will use `contextual: true` and know how to set that up. They probably don't. The generic "show" template has no body, so you don't really get a blog "out of the box" with this module.

We have to document this better if adding body to the schema is too much of a risk bc-wise, which I suppose it is. We could at least add it to "show.html" and document that you are expected to either use "contextual: true" or add a body field.

cc @colpanik @stuartromanek

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.