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 the Matomo developer getting started guide #770

Open
bx80 opened this issue Dec 6, 2023 · 2 comments
Open

Improve the Matomo developer getting started guide #770

bx80 opened this issue Dec 6, 2023 · 2 comments

Comments

@bx80
Copy link
Contributor

bx80 commented Dec 6, 2023

The developer getting started guide is out of date and is missing key steps required to easily setup a local development environment for contributing to Matomo or creating plugins.

Specific issues:

  • The git submodule update --init step is not detailed
  • Initial folder permission instruction are not covered
  • .htaccess files are not explained
  • A best practice method for setting up local SSL certificates is not provided
  • The guides doesn't explain workarounds for the visitor generator and SSL.

These issues are described in more detail in this excellent forum post

The guide should be updated and improved so that developers can quickly setup a working Matomo environment by just following the guide without having to search for external info or figure issues out by looking at code!

@MatomoForumNotifications

This issue has been mentioned on Matomo forums. There might be relevant details there:

https://forum.matomo.org/t/my-trials-installing-a-matomo-fork-on-wsl2-windows-11/54015/3

@michalkleiner
Copy link
Contributor

@bx80 we have an initiative that can address majority of these issues, I'll add a link to this issue so that we are aware of it. Should this issue be moved to the documentation repo, too?

@bx80 bx80 transferred this issue from matomo-org/matomo Dec 6, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

4 participants