Skip to content

Add docs for setting up a local dev environment#71

Open
jeancochrane wants to merge 6 commits intomasterfrom
jeancochrane/33-development-environment-onboarding
Open

Add docs for setting up a local dev environment#71
jeancochrane wants to merge 6 commits intomasterfrom
jeancochrane/33-development-environment-onboarding

Conversation

@jeancochrane
Copy link
Copy Markdown
Member

@jeancochrane jeancochrane commented Apr 21, 2026

This PR adds a new doc Handbook/Local-Dev-Environment-Setup.md that documents the steps required to set up a development environment on a local machine (i.e. a laptop).

I'm hoping I can get a couple folks to review this for clarity, and then one person (perhaps Kyra or Damon) to test it out and see if all the commands work.

Connects ccao-data/people#33.

@jeancochrane jeancochrane marked this pull request as ready for review May 5, 2026 19:52
@jeancochrane
Copy link
Copy Markdown
Member Author

Tagging in @ccao-jardine, @TimCookCountyDS, and @Damonamajor for testing this out.

@Damonamajor
Copy link
Copy Markdown
Contributor

I just added another ticket to get WSL and positron updated.

@ccao-jardine
Copy link
Copy Markdown
Member

Thanks @jeancochrane ! I'm testing this out. What are your thoughts on, under the steps for Tools that IT needs to install, adding text something like the following:

If these tools are not currently on your laptop, submit an IT Helpdesk Ticket. Under "Request New Service," then under "Software Installation," submit a "Software Installation Request" to install Office-authorized software. (This is not a "New Software/Subscription Request.") If you do not have this option, reach out to your manager.

Or, perhaps overkill?

@jeancochrane
Copy link
Copy Markdown
Member Author

jeancochrane commented May 6, 2026

I like that suggestion @ccao-jardine, though I don't see WSL in the "Software Installation Request" form dropdown. This is also the software that Damon hasn't successfully gotten IT to install yet -- the trick is that WSL 1 comes pre-installed on our laptops, but IT has to remote in with admin privileges to install WSL 2 from the WSL 1 shell. Should we try to work with them to get WSL added to this dropdown, or should we suggest a different path for requesting WSL installation?

image

@ccao-jardine
Copy link
Copy Markdown
Member

Let's see how @Damonamajor and I get routed through; I'll follow up.

@Damonamajor
Copy link
Copy Markdown
Contributor

I was told to restart my computer. I restarted my computer and sent the error message back to IT.

@ccao-jardine
Copy link
Copy Markdown
Member

Thanks! Seeing as this is ongoing, let's ignore my suggestion so that this PR isn't blocked. I'll open a ticket if it's worth adding steps about what to do if one's computer doesn't have Positron and/or WSL.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants