chapter-three
Update Documentation for Umami Demo
Package containing the bug
example-umami
Describe the bug
As reported on Slack, it is currently not possible to follow the Umami demo [instructions] without error.
Expected behavior
It should be possible to follow this walkthrough to create a fully functioning site - including all functionality that requires authentication.
Steps to reproduce:
Follow https://next-drupal.org/guides/umami-demo
From my experience, you'll run into composer dependency issues preventing you from even getting to installation. Patches also won't apply.
Without those patches, once you get the site running many links will 404 (likely due to the missing decoupled router patch.)
And then beyond that, you'll encounter an error when logging in, or attempting to use the contact form.
Additional context
Other notes:
- Patches need to be updated.
- Composer create project either needs to be updated to use ^10 or composer require step needs to be updated to use drupal/next@beta2 (as of this writing). jsonapi_resources should also now be able to use the stable version.
- The env.local step should probably use the functioning URL for Drupal's built in webserver: http://127.0.0.1:8888
- I had to use ../keys for the keys directory. Using the path in the instructions throws an error.
- In general, I found the local Drupal webserver to be unstable and had to restart it frequently. A timeout perhaps?
I also wonder if Umami is really still be best way to demonstrate what Next-Drupal can do. I feel like a recipe and a customized starter might do a better job given the tools we have today.
