Update about-the-website-development-team.md

[vraer]

Summary

This PR migrates the About the Website Development Team page from the GitHub wiki to the new mkdocs site.

• Location in GitHub wiki: https://github.com/hackforla/website/wiki/About-the-Website-Development-Team
• New location in website-wiki: docs/roles/dev/about-the-website-development-team.md

Changes

• Added mermaid diagram to visualize skill progression pathway
• Included note box to highlight exceptions can be discussed
• Formatted content for improved readability and consistency

Please review and let me know if any details need to be modified or expanded on.

---

Screenshots

Edit

Original

[vraer]

@JessicaLucindaCheng @roslynwythe

I've come across a few open issues related to content duplication (see below). As this PR is being considered, should we also think about instances where we can instead link back to a main source? Like meetings/schedule info or things that don't require additional context or explanation.

Examples of related issues

• ER: Update Zoom Link on Meetings and Agendas Wiki Page website#4918
• Update 'Joining the HFLA.org website team' wiki page website#2740
• Update the Web Developer wiki page website#2746
• ER: Wiki page documentation for each page on our website website#4543

To get this started, we could identify/review topics covered on high-traffic pages:

• Hack for LA website and Getting Started page
• CONTRIBUTING.md
• Pages linked in issue/PR templates or mentioned in Slack
• Pages referenced in issues

Thoughts?

[JessicaLucindaCheng]

@vraer

I've come across a few open issues related to content duplication (see below). As this PR is being considered, should we also think about instances where we can instead link back to a main source? Like meetings/schedule info or things that don't require additional context or explanation.

I think you make a good point about duplicate content and that it is better to link to one source. I will keep that in mind for #2746 (the issue I am assigned to). Also, I'll see if there is anything on the "About the Website Development Team" that we can have links to instead of repeating on the page when I review your pr.

I can't comment on the particulars of the other issues you listed but in general, I think not repeating content is a good idea. Since @roslynwythe is the current Tech Lead, I'll let her answer your other questions and provide guidance on what she thinks should be worked on next.

[JessicaLucindaCheng]

@vraer Good job refining and rewording the original content! I think it is a lot better.

See my in-line change requests. Thanks!

[JessicaLucindaCheng]

@vraer One more in-line change request.

[JessicaLucindaCheng]

@vraer Leaving this as only as suggestions for future versions of this page and not necessary to implement for this pr:

• Team Levels section could probably go on the Joining the hackforla org website team wiki page.
  • The wording would need to be generalized, so Development Team and new developers could be changed to Website Team and new members, respectively
• Time Commitment, Communication, Skill Progression, and probably the line "Work on one issue at a time" could probably go on the Joining the hackforla org website team wiki page because I think these requirements apply to all members and not just devs.
  • The info could probably go in section 2.1 Hack for LA in CONTRIBUTING.md as well instead of the wiki. However, I think it makes more sense to put the content in the wiki and link it in section 2.1.
• If a line was added to the "Let's go!" section on Joining the hackforla org website team wiki page saying something like, "Please read the Website Team's" information page to learn about the team, including tools, technologies, and languages we use and our meeting times", I think the Technologies Used section could be omitted.
• Info for Meetings section, and "Wait until your pull request is merged before working on another issue." could probably be moved to the Web Developer wiki page.
  • Though, a better option might be to link to the info in section 2.1 Hack for LA in CONTRIBUTING.md in the Web Developer wiki page because the meetings and the info about prs are already in section 2.1.

[JessicaLucindaCheng]

@vraer LGTM!