farmos/farmos-community-blog

Community blog posts hosted on the farmOS.org website

farmOS Community Blog

Official community content for the farmOS.org website.

For more details, see the "Community features & content" section of the proposal to redsign farmOS.org

farmos-community-blog's Issues

Document contribution process and guidelines

Now that we have an official repo for the blog, we should document what the process and guidelines are for making contributions to it.

I figure this can go in the README.md file.

Blog categories

It would be nice if we could add categories to blog posts in their markdown front matter, and perhaps have the ability to filter by category on farmOS.org.

This idea came up in early discussions when the farmOS Community Blog was first being built.

One specific use-case I have in mind is to add a "Newsletter" category, and start using the blog as a home for newsletter content, which we can then send to subscribers as well as post to the blog.

Add front matter for farmOS version

Proposed here: https://farmos.discourse.group/t/first-blog-posts-brainstorm-dev-call-2022-06-09/1264/14?u=mstenta

Build netlify previews for proposed posts

Building on from #4

It would be nice to see a preview of proposed blog posts. As I understand we would need to trigger a Netlify build preview on PRs similar to how this works in farmos/farmos.org. But I think Netlfiy does that automatically so we might need to implement this one ourselves - cc @jgaehring :-)

Add workflow to trigger farmOS.org Netlify builds when posts are added

See:

• farmOS/farmOS#456
• Latest file https://github.com/farmOS/farmOS/blob/2.x/.github/workflows/netlify-build-docs.yml

Setting Up farmOS With DDEV and Composer

DDEV is a great way to build Drupal (and other PHP-based) projects in a local environment; when combined with Colima and Mutagen, not only is the requirement for Docker desktop removed, but performance can be impressively fast. Instructions on setting up DDEV are at https://ddev.readthedocs.io/en/latest/users/install/

The recommended method to install a farmOS local development environment (https://farmos.org/development/environment) is via a Docker container, but this may not work well with Colima.

For certain local environments, installing farmOS by Composer may be more straightforward. The following commands would allow farmOS to be installed in a DDEV container:

mkdir farmos-ddev
cd farmos-ddev
ddev config --project-type=drupal9 --docroot=web --create-docroot
ddev start
ddev composer create "farmos/project:2.x-dev"
ddev composer require drush/drush
ddev drush site:install --account-name=admin --account-pass=admin -y
ddev drush uli
ddev launch

(HT @wotnak)

Add front matter for updated date

See https://farmos.discourse.group/t/first-blog-posts-brainstorm-dev-call-2022-06-09/1264/15