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

Update Documentation for Umami Demo #806

Open
backlineint opened this issue Oct 18, 2024 · 0 comments
Open

Update Documentation for Umami Demo #806

backlineint opened this issue Oct 18, 2024 · 0 comments
Labels
bug Something isn't working triage A new issue that needs triage

Comments

@backlineint
Copy link
Collaborator

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.

@backlineint backlineint added bug Something isn't working triage A new issue that needs triage labels Oct 18, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
bug Something isn't working triage A new issue that needs triage
Projects
None yet
Development

No branches or pull requests

1 participant