hackforla / hackforla/tdm-calculator

Product: Epic: Rename “Project” to “TDM Plan” Across the Application

Open
#3,199 53 comments 0 reactions 1 assignee View on GitHub

@ngorokh is already working on this.

Since May 12, 2026.

deck: stakeholder presentation epic level: hard p-feature: Login p-feature: My Projects p-feature: My Projects-Deleted Tab p-feature: Project Page p1 p-feature: Project Specifications Page p2 p-feature: Strategies Page p4 p-feature: Target Points Page p3 priority: SHOULD HAVE ready for product role: Product Management size: 2pt
Dominant language
JavaScript
Stars
68
Forks
47
Avg merge
3d 9h
Merged PRs (30d)
25

Description

### Overview
Rename in-system references from “Project” to “TDM Plan” across the application where applicable to improve terminology clarity and reduce ambiguity between real estate projects and user-created TDM plans.

### Action Items
- [x] Review application terminology page-by-page and create Comments with each reference to project
- [x] Identify where “project” should remain unchanged
- [x] Identify where “project” should be updated to “TDM plan”
- [x] Add screenshots and recommendations for each identified instance
- [ ] Create related dev/product issues as findings are grouped

#### Initial Issues/Epics To Create
- [ ] Create dev issue: Rename "Project ID`" -> "Plan ID"
- [ ] Plan Summary (Page 5 of a draft or snapshot)
- [ ] Manage Submissions
- [ ] Edit Submission Status modal
- [ ] Create epic: Rename “Project” -> “TDM Plan”
- [ ] Create Dev sub-issue(s)
- [ ] Dev: Rename menu item "My Projects" to "My TDM Plans"
- [ ] Product: Rename FAQ references from "My Projects" to "My TDM Plans"
- [ ] Create epic: Rename “Create Project” -> “Create TDM Plan”
- [ ] Dev: Rename menu item "My Projects" to "My TDM Plans"
- [ ] Product: Rename FAQ references from "My Projects" to "My TDM Plans"
- [ ] Review with product and dev. Update if needed based on feedback
- [ ] Once finalized, add before and after images to the slide in the staging deck for this issue (see link under resources)
- [ ] Get Stakeholder sign-off via the stakeholder meeting slide deck.

### Resources/Instructions
#### Core Terminology Decision

- “Project” refers to the real estate development/project itself
- “TDM plan” refers to the in-system item users create/edit/configure

#### Guidance

Keep “project” when referring to:
- Real estate developments
- Project-level metadata
- External/project context

Change to “TDM plan” when referring to:
- User-created plans
- Plan workflows
- Plan configuration/editing
- Plan submission flows

#### Review Process

For each identified instance:
- Add screenshot
- Include exact text
- Add recommendation:
- Change to “TDM plan”
- Keep as “project”

#### Comment Template

```markdown
Role: [paste role: Visitor/User/Admin/Security/Admin + Security]
URL: [paste URL]
Wording:
`[paste exact wording]`
Recommendation
- [ ] Change to TDM Plan
- [ ] Keep as project or Project

Screenshot: Page X, Section Name

[paste screenshot here]

---

- [ ] Recommendation Approved

```

#### FAQ Handling

FAQ updates will be handled separately through batch processing/automation and do not require manual per-instance review.

#### Areas To Review

- [ ] Navigation/menu items
- [ ] Forms/modals
- [ ] Tooltips/help text
- [ ] Table headers
- [ ] Empty states
- [ ] Validation/error messaging
- [ ] Submission workflows
- [ ] Plan creation/edit flows

#### Staging and Release decks
- [Staging Deck](https://docs.google.com/presentation/d/1crZ3IxqA4hAu3qzD7ns93Ieuqjwh6wyEtuX_46cP-fg/)
- ~[Staging slide, 3199 slide 1](https://docs.google.com/presentation/d/1crZ3IxqA4hAu3qzD7ns93Ieuqjwh6wyEtuX_46cP-fg/edit?slide=id.g3e9280fa56e_32_7)~
- ~[Staging slide, 3199 slide 2](https://docs.google.com/presentation/d/1crZ3IxqA4hAu3qzD7ns93Ieuqjwh6wyEtuX_46cP-fg/edit?slide=id.g3ea12f563f8_0_8)~
- ~[Staging slide, 3199 slide 3](https://docs.google.com/presentation/d/1crZ3IxqA4hAu3qzD7ns93Ieuqjwh6wyEtuX_46cP-fg/edit?slide=id.g3ea12f563f8_0_21)~
- ~[Staging slide, 3199 slide 4](https://docs.google.com/presentation/d/1crZ3IxqA4hAu3qzD7ns93Ieuqjwh6wyEtuX_46cP-fg/edit?slide=id.g3ea12f563f8_0_32)~
- ~[Staging slide, 3199 slide 5](https://docs.google.com/presentation/d/1crZ3IxqA4hAu3qzD7ns93Ieuqjwh6wyEtuX_46cP-fg/edit?slide=id.g3ea12f563f8_0_45)~
- ~[Staging slide, 3199 slide 6](https://docs.google.com/presentation/d/1crZ3IxqA4hAu3qzD7ns93Ieuqjwh6wyEtuX_46cP-fg/edit?slide=id.g3ea12f563f8_0_56)~
- ~[Staging slide, 3199 slide 7](https://docs.google.com/presentation/d/1crZ3IxqA4hAu3qzD7ns93Ieuqjwh6wyEtuX_46cP-fg/edit?slide=id.g3ea12f563f8_0_93)~
- ~[Staging slide, 3199 slide 8](https://docs.google.com/presentation/d/1crZ3IxqA4hAu3qzD7ns93Ieuqjwh6wyEtuX_46cP-fg/edit?slide=id.g3ea12f563f8_0_75)~
- ~[Staging slide, 3199 slide 9](https://docs.google.com/presentation/d/1crZ3IxqA4hAu3qzD7ns93Ieuqjwh6wyEtuX_46cP-fg/edit?slide=id.g3ea12f563f8_0_107)~
- ~[Staging slide, 3199 slide 10](https://docs.google.com/presentation/d/1crZ3IxqA4hAu3qzD7ns93Ieuqjwh6wyEtuX_46cP-fg/edit?slide=id.g3ea12f563f8_0_122)~
- ~[Staging slide, 3199 slide 11](https://docs.google.com/presentation/d/1crZ3IxqA4hAu3qzD7ns93Ieuqjwh6wyEtuX_46cP-fg/edit?slide=id.g3ea12f563f8_0_132)~
- ~[Staging slide, 3199 slide 12](https://docs.google.com/presentation/d/1crZ3IxqA4hAu3qzD7ns93Ieuqjwh6wyEtuX_46cP-fg/edit?slide=id.g3ea12f563f8_0_141)~
- ~[Staging slide, 3199 slide 13](https://docs.google.com/presentation/d/1crZ3IxqA4hAu3qzD7ns93Ieuqjwh6wyEtuX_46cP-fg/edit?slide=id.g3ea12f563f8_0_157)~
- ~[Staging slide, 3199 slide 14](https://docs.google.com/presentation/d/1crZ3IxqA4hAu3qzD7ns93Ieuqjwh6wyEtuX_46cP-fg/edit?slide=id.g3ea12f563f8_0_170)~
- ~[Staging slide, 3199 slide 15](https://docs.google.com/presentation/d/1crZ3IxqA4hAu3qzD7ns93Ieuqjwh6wyEtuX_46cP-fg/edit?slide=id.g3ea12f563f8_0_182)~
- ~[Staging slide, 3199 slide 16](https://docs.google.com/presentation/d/1crZ3IxqA4hAu3qzD7ns93Ieuqjwh6wyEtuX_46cP-fg/edit?slide=id.g3ea12f563f8_0_198)~
- ~[Staging slide, 3199 slide 17](https://docs.google.com/presentation/d/1crZ3IxqA4hAu3qzD7ns93Ieuqjwh6wyEtuX_46cP-fg/edit?slide=id.g3ea12f563f8_0_212)~
- ~[Staging slide, 3199 slide 18](https://docs.google.com/presentation/d/1crZ3IxqA4hAu3qzD7ns93Ieuqjwh6wyEtuX_46cP-fg/edit?slide=id.g3ea12f563f8_0_225)~
- ~[Staging slide, 3199 slide 19](https://docs.google.com/presentation/d/1crZ3IxqA4hAu3qzD7ns93Ieuqjwh6wyEtuX_46cP-fg/edit?slide=id.g3ea12f563f8_0_238)~
- ~[Staging slide, 3199 slide 20](https://docs.google.com/presentation/d/1crZ3IxqA4hAu3qzD7ns93Ieuqjwh6wyEtuX_46cP-fg/edit?slide=id.g3ea47eb6b8a_18_1)~
- ~[Staging slide, 3199 slide 21](https://docs.google.com/presentation/d/1crZ3IxqA4hAu3qzD7ns93Ieuqjwh6wyEtuX_46cP-fg/edit?slide=id.g3ea47eb6b8a_18_15)~
- ~[Staging slide, 3199 slide 22](https://docs.google.com/presentation/d/1crZ3IxqA4hAu3qzD7ns93Ieuqjwh6wyEtuX_46cP-fg/edit?slide=id.g3ea47eb6b8a_18_34)~
- ~[Staging slide, 3199 slide 23](https://docs.google.com/presentation/d/1crZ3IxqA4hAu3qzD7ns93Ieuqjwh6wyEtuX_46cP-fg/edit?slide=id.g3ea47eb6b8a_18_46)~
- ~[Staging slide, 3199 slide 24](https://docs.google.com/presentation/d/1crZ3IxqA4hAu3qzD7ns93Ieuqjwh6wyEtuX_46cP-fg/edit?slide=id.g3ea47eb6b8a_18_60)~
- ~[Staging slide, 3199 slide 25](https://docs.google.com/presentation/d/1crZ3IxqA4hAu3qzD7ns93Ieuqjwh6wyEtuX_46cP-fg/edit?slide=id.g3ea519af888_0_4)~
- ~[Staging slide, 3199 slide 26](https://docs.google.com/presentation/d/1crZ3IxqA4hAu3qzD7ns93Ieuqjwh6wyEtuX_46cP-fg/edit?slide=id.g3ea519af888_0_30)~
- ~[Staging slide, 3199 slide 27](https://docs.google.com/presentation/d/1crZ3IxqA4hAu3qzD7ns93Ieuqjwh6wyEtuX_46cP-fg/edit?slide=id.g3ea519af888_0_16)~
- ~[Staging slide, 3199 slide 28](https://docs.google.com/presentation/d/1crZ3IxqA4hAu3qzD7ns93Ieuqjwh6wyEtuX_46cP-fg/edit?slide=id.g3ea519af888_0_42)~
- ~[Staging slide, 3199 slide 29](https://docs.google.com/presentation/d/1crZ3IxqA4hAu3qzD7ns93Ieuqjwh6wyEtuX_46cP-fg/edit?slide=id.g3ea519af888_0_55)~
- ~[Staging slide, 3199 slide 30](https://docs.google.com/presentation/d/1crZ3IxqA4hAu3qzD7ns93Ieuqjwh6wyEtuX_46cP-fg/edit?slide=id.g3ea519af888_0_66)~
- ~[Staging slide, 3199 slide 31](https://docs.google.com/presentation/d/1crZ3IxqA4hAu3qzD7ns93Ieuqjwh6wyEtuX_46cP-fg/edit?slide=id.g3ea519af888_0_81)~
- ~[Staging slide, 3199 slide 32](https://docs.google.com/presentation/d/1crZ3IxqA4hAu3qzD7ns93Ieuqjwh6wyEtuX_46cP-fg/edit?slide=id.g3ea519af888_0_94)~
- ~[Staging slide, 3199 slide 33](https://docs.google.com/presentation/d/1crZ3IxqA4hAu3qzD7ns93Ieuqjwh6wyEtuX_46cP-fg/edit?slide=id.g3ea519af888_0_118)~
- ~[Staging slide, 3199 slide 34](https://docs.google.com/presentation/d/1crZ3IxqA4hAu3qzD7ns93Ieuqjwh6wyEtuX_46cP-fg/edit?slide=id.g3ea519af888_0_108)~
- ~[Staging slide, 3199 slide 35](https://docs.google.com/presentation/d/1crZ3IxqA4hAu3qzD7ns93Ieuqjwh6wyEtuX_46cP-fg/edit?slide=id.g3ea519af888_0_131)~
- ~[Staging slide, 3199 slide 36](https://docs.google.com/presentation/d/1crZ3IxqA4hAu3qzD7ns93Ieuqjwh6wyEtuX_46cP-fg/edit?slide=id.g3ea519af888_0_144)~
- ~[Staging slide, 3199 slide 37](https://docs.google.com/presentation/d/1crZ3IxqA4hAu3qzD7ns93Ieuqjwh6wyEtuX_46cP-fg/edit?slide=id.g3ea519af888_0_155)~
- Release Deck
- [2026-06-09 Release deck, 3199 slide 1](https://docs.google.com/presentation/d/1PmFeErBaJ5C2pljGF8wG-OgxIUy6NYfXITvlod0KVl4/edit?slide=id.g3ea6cf237f1_0_653)
- [2026-06-09 Release deck, 3199 slide 2](https://docs.google.com/presentation/d/1PmFeErBaJ5C2pljGF8wG-OgxIUy6NYfXITvlod0KVl4/edit?slide=id.g3ea6cf237f1_0_661#slide=id.g3ea6cf237f1_0_661)
- [2026-06-09 Release deck, 3199 slide 3](https://docs.google.com/presentation/d/1PmFeErBaJ5C2pljGF8wG-OgxIUy6NYfXITvlod0KVl4/edit?slide=id.g3ea6cf237f1_0_669#slide=id.g3ea6cf237f1_0_669)
- [2026-06-09 Release deck, 3199 slide 4](https://docs.google.com/presentation/d/1PmFeErBaJ5C2pljGF8wG-OgxIUy6NYfXITvlod0KVl4/edit?slide=id.g3ea6cf237f1_0_677#slide=id.g3ea6cf237f1_0_677)
- [2026-06-09 Release deck, 3199 slide 5](https://docs.google.com/presentation/d/1PmFeErBaJ5C2pljGF8wG-OgxIUy6NYfXITvlod0KVl4/edit?slide=id.g3ea6cf237f1_0_685#slide=id.g3ea6cf237f1_0_685)
- [2026-06-09 Release deck, 3199 slide 6](https://docs.google.com/presentation/d/1PmFeErBaJ5C2pljGF8wG-OgxIUy6NYfXITvlod0KVl4/edit?slide=id.g3ea6cf237f1_0_693#slide=id.g3ea6cf237f1_0_693)
- [2026-06-09 Release deck, 3199 slide 7](https://docs.google.com/presentation/d/1PmFeErBaJ5C2pljGF8wG-OgxIUy6NYfXITvlod0KVl4/edit?slide=id.g3ea6cf237f1_0_704#slide=id.g3ea6cf237f1_0_704)
- [2026-06-09 Release deck, 3199 slide 8](https://docs.google.com/presentation/d/1PmFeErBaJ5C2pljGF8wG-OgxIUy6NYfXITvlod0KVl4/edit?slide=id.g3ea6cf237f1_0_712#slide=id.g3ea6cf237f1_0_712)
- [2026-06-09 Release deck, 3199 slide 9](https://docs.google.com/presentation/d/1PmFeErBaJ5C2pljGF8wG-OgxIUy6NYfXITvlod0KVl4/edit?slide=id.g3ea6cf237f1_0_720#slide=id.g3ea6cf237f1_0_720)
- [2026-06-09 Release deck, 3199 slide 10](https://docs.google.com/presentation/d/1PmFeErBaJ5C2pljGF8wG-OgxIUy6NYfXITvlod0KVl4/edit?slide=id.g3ea6cf237f1_0_728#slide=id.g3ea6cf237f1_0_728)
- [2026-06-09 Release deck, 3199 slide 11](https://docs.google.com/presentation/d/1PmFeErBaJ5C2pljGF8wG-OgxIUy6NYfXITvlod0KVl4/edit?slide=id.g3ea6cf237f1_0_738#slide=id.g3ea6cf237f1_0_738)
- [2026-06-09 Release deck, 3199 slide 12](https://docs.google.com/presentation/d/1PmFeErBaJ5C2pljGF8wG-OgxIUy6NYfXITvlod0KVl4/edit?slide=id.g3ea6cf237f1_0_746#slide=id.g3ea6cf237f1_0_746)
- [2026-06-09 Release deck, 3199 slide 13](https://docs.google.com/presentation/d/1PmFeErBaJ5C2pljGF8wG-OgxIUy6NYfXITvlod0KVl4/edit?slide=id.g3ea6cf237f1_0_754#slide=id.g3ea6cf237f1_0_754)
- [2026-06-09 Release deck, 3199 slide 14](https://docs.google.com/presentation/d/1PmFeErBaJ5C2pljGF8wG-OgxIUy6NYfXITvlod0KVl4/edit?slide=id.g3ea6cf237f1_0_762#slide=id.g3ea6cf237f1_0_762)
- [2026-06-09 Release deck, 3199 slide 15](https://docs.google.com/presentation/d/1PmFeErBaJ5C2pljGF8wG-OgxIUy6NYfXITvlod0KVl4/edit?slide=id.g3ea6cf237f1_0_770#slide=id.g3ea6cf237f1_0_770)
- [2026-06-09 Release deck, 3199 slide 16](https://docs.google.com/presentation/d/1PmFeErBaJ5C2pljGF8wG-OgxIUy6NYfXITvlod0KVl4/edit?slide=id.g3ea6cf237f1_0_781#slide=id.g3ea6cf237f1_0_781)
- [2026-06-09 Release deck, 3199 slide 17](https://docs.google.com/presentation/d/1PmFeErBaJ5C2pljGF8wG-OgxIUy6NYfXITvlod0KVl4/edit?slide=id.g3ea6cf237f1_0_789#slide=id.g3ea6cf237f1_0_789)
- [2026-06-09 Release deck, 3199 slide 18](https://docs.google.com/presentation/d/1PmFeErBaJ5C2pljGF8wG-OgxIUy6NYfXITvlod0KVl4/edit?slide=id.g3ea6cf237f1_0_797#slide=id.g3ea6cf237f1_0_797)
- [2026-06-09 Release deck, 3199 slide 19](https://docs.google.com/presentation/d/1PmFeErBaJ5C2pljGF8wG-OgxIUy6NYfXITvlod0KVl4/edit?slide=id.g3ea6cf237f1_0_807#slide=id.g3ea6cf237f1_0_807)
- [2026-06-09 Release deck, 3199 slide 20](https://docs.google.com/presentation/d/1PmFeErBaJ5C2pljGF8wG-OgxIUy6NYfXITvlod0KVl4/edit?slide=id.g3ea6cf237f1_0_817#slide=id.g3ea6cf237f1_0_817)
- [2026-06-09 Release deck, 3199 slide 21](https://docs.google.com/presentation/d/1PmFeErBaJ5C2pljGF8wG-OgxIUy6NYfXITvlod0KVl4/edit?slide=id.g3ea6cf237f1_0_827#slide=id.g3ea6cf237f1_0_827)
- [2026-06-09 Release deck, 3199 slide 22](https://docs.google.com/presentation/d/1PmFeErBaJ5C2pljGF8wG-OgxIUy6NYfXITvlod0KVl4/edit?slide=id.g3ea6cf237f1_0_837#slide=id.g3ea6cf237f1_0_837)
- [2026-06-09 Release deck, 3199 slide 23](https://docs.google.com/presentation/d/1PmFeErBaJ5C2pljGF8wG-OgxIUy6NYfXITvlod0KVl4/edit?slide=id.g3ea6cf237f1_0_847#slide=id.g3ea6cf237f1_0_847)
- [2026-06-09 Release deck, 3199 slide 24](https://docs.google.com/presentation/d/1PmFeErBaJ5C2pljGF8wG-OgxIUy6NYfXITvlod0KVl4/edit?slide=id.g3ea6cf237f1_0_855#slide=id.g3ea6cf237f1_0_855)
- [2026-06-09 Release deck, 3199 slide 25](https://docs.google.com/presentation/d/1PmFeErBaJ5C2pljGF8wG-OgxIUy6NYfXITvlod0KVl4/edit?slide=id.g3ea6cf237f1_0_865#slide=id.g3ea6cf237f1_0_865)
- [2026-06-09 Release deck, 3199 slide 26](https://docs.google.com/presentation/d/1PmFeErBaJ5C2pljGF8wG-OgxIUy6NYfXITvlod0KVl4/edit?slide=id.g3ea6cf237f1_0_875#slide=id.g3ea6cf237f1_0_875)
- [2026-06-09 Release deck, 3199 slide 27](https://docs.google.com/presentation/d/1PmFeErBaJ5C2pljGF8wG-OgxIUy6NYfXITvlod0KVl4/edit?slide=id.g3ea6cf237f1_0_885#slide=id.g3ea6cf237f1_0_885)
- [2026-06-09 Release deck, 3199 slide 28](https://docs.google.com/presentation/d/1PmFeErBaJ5C2pljGF8wG-OgxIUy6NYfXITvlod0KVl4/edit?slide=id.g3ea6cf237f1_0_893#slide=id.g3ea6cf237f1_0_893)
- [2026-06-09 Release deck, 3199 slide 29](https://docs.google.com/presentation/d/1PmFeErBaJ5C2pljGF8wG-OgxIUy6NYfXITvlod0KVl4/edit?slide=id.g3ea6cf237f1_0_901#slide=id.g3ea6cf237f1_0_901)
- [2026-06-09 Release deck, 3199 slide 30](https://docs.google.com/presentation/d/1PmFeErBaJ5C2pljGF8wG-OgxIUy6NYfXITvlod0KVl4/edit?slide=id.g3ea6cf237f1_0_911#slide=id.g3ea6cf237f1_0_911)
- [2026-06-09 Release deck, 3199 slide 31](https://docs.google.com/presentation/d/1PmFeErBaJ5C2pljGF8wG-OgxIUy6NYfXITvlod0KVl4/edit?slide=id.g3ea6cf237f1_0_919#slide=id.g3ea6cf237f1_0_919)
- [2026-06-09 Release deck, 3199 slide 32](https://docs.google.com/presentation/d/1PmFeErBaJ5C2pljGF8wG-OgxIUy6NYfXITvlod0KVl4/edit?slide=id.g3ea6cf237f1_0_931#slide=id.g3ea6cf237f1_0_931)
- [2026-06-09 Release deck, 3199 slide 33](https://docs.google.com/presentation/d/1PmFeErBaJ5C2pljGF8wG-OgxIUy6NYfXITvlod0KVl4/edit?slide=id.g3ea6cf237f1_0_939#slide=id.g3ea6cf237f1_0_939)
- [2026-06-09 Release deck, 3199 slide 34](https://docs.google.com/presentation/d/1PmFeErBaJ5C2pljGF8wG-OgxIUy6NYfXITvlod0KVl4/edit?slide=id.g3ea6cf237f1_0_950#slide=id.g3ea6cf237f1_0_950)
- [2026-06-09 Release deck, 3199 slide 35](https://docs.google.com/presentation/d/1PmFeErBaJ5C2pljGF8wG-OgxIUy6NYfXITvlod0KVl4/edit?slide=id.g3ea6cf237f1_0_959#slide=id.g3ea6cf237f1_0_959)
- [2026-06-09 Release deck, 3199 slide 36](https://docs.google.com/presentation/d/1PmFeErBaJ5C2pljGF8wG-OgxIUy6NYfXITvlod0KVl4/edit?slide=id.g3ea6cf237f1_0_967#slide=id.g3ea6cf237f1_0_967)
- [2026-06-09 Release deck, 3199 slide 37](https://docs.google.com/presentation/d/1PmFeErBaJ5C2pljGF8wG-OgxIUy6NYfXITvlod0KVl4/edit?slide=id.g3ea6cf237f1_0_975#slide=id.g3ea6cf237f1_0_975)
- [2026-06-09 Release deck, slide 3199](https://docs.google.com/presentation/d/1lBLDKK_hpjf_eWEjoVGg1RRqsxEh7RYEnFYDyuzbppE/edit?slide=id.g3f8db00cf0a_124_0#slide=id.g3f8db00cf0a_124_0)

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.