311-data icon indicating copy to clipboard operation
311-data copied to clipboard

New tech stack documentation

Open edwinjue opened this issue 1 year ago • 2 comments

Overview

We need a volunteer to go through the steps in the Quick Start and document the process on getting the new tech stack set up so it is easy for new volunteers to set up a local development environment.

The following would be an added bonus to the documentation:

  • Diagrams
  • Screenshots
  • Visuals

Remember your target audience has absolutely no idea what is going on and the goal is to be a simple and direct a possible.

Refer to the System Architecture section of the archived aws CONTRIBUTING.md document for reference

Action Items

  • [ ] @edwinjue will provide an outline of the NRD System Architecture
  • [ ] Participants will contribute bullet points/details to each part of the outline (can be completed in Google Drive, but provide a link to it below)
  • [ ] Finally, add this "new tech stack" documentation to the bottom of CONTRIBUTING.md when it becomes available (need to wait for #1556 to be completed)

Active PR

  • https://github.com/hackforla/311-data/pull/1610

Resources/Instructions

Refer to the archived aws CONTRIBUTING.md for reference

edwinjue avatar Aug 09 '23 18:08 edwinjue

Moving this to In Review, since there is a PR out for review on this. Clearing assignees unless someone is actively working on this ticket or actively modifying the ticket.

ryanfchase avatar Jan 24 '24 21:01 ryanfchase

I'm moving this ticket back to New Issue Approval. One PR was completed for this PR, but this issue feels more like an Epic. Which is fine, but it should be organized as such -- and smaller issues should be broken down to provide detailed instruction for devs.

aka the issue is to nebulous, I think a dev or dev lead could break this down into even smaller Good First Issue tickets

ryanfchase avatar Jan 30 '24 02:01 ryanfchase