BlackPythonDevs / blackpythondevs.github.io

Website for Black Python Devs
https://blackpythondevs.com
MIT License
29 stars 43 forks source link

Make local development significantly easier #401

Open kjaymiller opened 4 weeks ago

kjaymiller commented 4 weeks ago

I'm not sure why but I am completely unable to run this project outside of a devcontainer or codespace.

I'm not sure if it's issues with my local Ruby setup or not.

I'm open to different suggestions on this but the more we force folks to use codespaces then we limit their contribution based on what they are willing to pay for.

Suggestions

Diagram

We need a diagram of the infrastructure to better understand the different tools that we're using.

Dockerfile

Beauty of a dockerfile is that it can be the source for the codespace (we don't have access to the existing codespace dockerfile so we'd likely need to start over. It also means that we can implement this across operating systems as well.

Make or Invoke

I don't have a preference on this but we should make it simple to setup, test, lint and run services regardless of the language.

I would probably be more comfortable with invoke since it's python code but if someone knows enough about make to make it easy to follow I wouldn't mind.

dragid10 commented 3 weeks ago

Don't know if it helps at all, but I am totally able to run this repo locally! I think I was fortunate enough to have already setup my ruby environment when I was learning Jekyll

dragid10 commented 1 week ago

I might end up wanting to take this issue as well just because I'm setting up the repo on a new laptop and can document the steps.