Improve Local Dev Setup Documentation and Contribution Guidelines #339

Merged
zachgoll merged 3 commits from add-local-dev-setup-guides into main 2024-02-07 07:14:52 +08:00
zachgoll commented 2024-02-07 05:18:32 +08:00 (Migrated from github.com)

We've had several local setup issues and self-hosting questions:

The goal of this PR is to consolidate all of these into one spot.

I've updated the README and CONTRIBUTING guide alongside some additional setup guides in the Wiki:

These guides are a WIP and will be centralized places for us to communicate the best way to get started for local development and self-hosting.

We've had several local setup issues and self-hosting questions: - #335 - #316 - #306 - #295 - #292 The goal of this PR is to consolidate all of these into one spot. I've updated the README and CONTRIBUTING guide alongside some additional setup guides in the Wiki: - [Self Hosting](https://github.com/maybe-finance/maybe/wiki/Self-Hosting-Setup-Guide) - [Mac Setup](https://github.com/maybe-finance/maybe/wiki/Mac-Dev-Setup-Guide) - [Linux Setup](https://github.com/maybe-finance/maybe/wiki/Linux-Dev-Setup-Guide) - [Windows Setup](https://github.com/maybe-finance/maybe/wiki/Windows-Dev-Setup-Guide) These guides are a WIP and will be centralized places for us to communicate the best way to get started for local development and self-hosting.
cartwatson commented 2024-02-07 05:30:02 +08:00 (Migrated from github.com)

As someone currently trying to get this setup for dev this looks useful to me. Only thing that stood out was line 38 of the README, it gets rid of the shell syntax highlighting, admittedly not that useful but better to have it imo.

As someone currently trying to get this setup for dev this looks useful to me. Only thing that stood out was line 38 of the README, it gets rid of the shell syntax highlighting, admittedly not that useful but better to have it imo.
robzolkos commented 2024-02-07 05:42:11 +08:00 (Migrated from github.com)

This is amazingly well done 👏🏻

Notice in the individual setup guides in the wiki it mentions setting up Node - however - so far - the codebase doesn't need it (using importmaps instead), so perhaps some setup complexity that could be removed from the wiki?

This is amazingly well done 👏🏻 Notice in the individual setup guides in the wiki it mentions setting up Node - however - so far - the codebase doesn't need it (using importmaps instead), so perhaps some setup complexity that could be removed from the wiki?
zachgoll commented 2024-02-07 06:01:43 +08:00 (Migrated from github.com)

@robzolkos good point, will remove those for now!

@robzolkos good point, will remove those for now!
leemcalilly commented 2024-02-07 06:11:15 +08:00 (Migrated from github.com)

Should using Docker with the dev container be included or are y'all thinking about moving away from that?

Should using Docker with the dev container be included or are y'all thinking about moving away from that?
zachgoll commented 2024-02-07 06:38:05 +08:00 (Migrated from github.com)

@leemcalilly are you referring to adding a dedicated guide for developing locally with Dev Containers?

@robzolkos may have to jump in on that one—I'm not using the Dev Container myself but I've seen a few questions surrounding it.

@leemcalilly are you referring to adding a dedicated guide for developing locally with Dev Containers? @robzolkos may have to jump in on that one—I'm not using the Dev Container myself but I've seen a few questions surrounding it.
Sign in to join this conversation.