Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Need an architectural and systems design diagram for the freeCodeCamp classroom project #372

Closed
lloydchang opened this issue Jul 15, 2023 · 10 comments · Fixed by #392
Closed
Assignees

Comments

@lloydchang
Copy link
Contributor

Describe the bug
Need an architectural and systems design diagram for the freeCodeCamp classroom project

To Reproduce
Steps to reproduce the behavior:

  1. Go to https://github.com/freeCodeCamp/classroom/
  2. Read https://github.com/freeCodeCamp/classroom/#readme
  3. Documentation references source code, but I don't see any architectural or system design diagrams
  4. I could use an architectural and system design diagram based on the steps described in https://bit.ly/SystemDesignInterview

Expected behavior
An architectural and system design diagram hosted at https://excalidraw.com/ based on the steps described in https://bit.ly/SystemDesignInterview would be helpful to mentors like me.

Additional context
I am mentoring students working on freeCodeCamp/classroom and I am not understanding the architectural and system design of freeCodeCamp/classroom by reading https://github.com/freeCodeCamp/classroom/#readme — without diving deeper into the codebase.

@utsab
Copy link
Collaborator

utsab commented Jul 16, 2023

HI @lloydchang, I'm glad you pointed out the lack of documentation for a system design diagram. Thanks for providing the resources to create such a diagram. As the project maintainer, I'll start working on this, or if one of your mentees is already planning to work on it, I'm happy to answer questions.

@lloydchang
Copy link
Contributor Author

@utsab Thank you for being happy to answer questions!

Our CodeDay Labs student @Komal914 is interested in working on this issue.

Context: @Komal914 wrote in CodeDay Labs Slack:

I would be happy to give this issue a try! I have never worked to create an architecture diagram for codebases, so I think it would be a great learning opportunity for me 😊

Cc @sijin-raj @theGaryLarson @ngillux

@lloydchang
Copy link
Contributor Author

lloydchang commented Jul 17, 2023

@Komal914
Copy link
Contributor

Komal914 commented Jul 18, 2023

Hi! I will be happy to work on this issue with @lloydchang and @ngillux :)

@utsab
Copy link
Collaborator

utsab commented Jul 18, 2023

HI @lloydchang -- We have an internal list of priorities which we have not yet translated into formal github issues. I'll try to create a few more public issues by next week. In the meantime, I assigned Issue #166 to @theGaryLarson.

@Komal914
Copy link
Contributor

Hi @utsab, I am not sure exactly what the requirements are for this design. Here is the latest version of this design:

https://www.canva.com/design/DAFo8ezu7W8/EfUE0hjSDuJHFRGnG9NOvQ/edit?utm_content=DAFo8ezu7W8&utm_campaign=designshare&utm_medium=link2&utm_source=sharebutton

@Komal914
Copy link
Contributor

System Diagram

@Komal914
Copy link
Contributor

Komal914 commented Jul 25, 2023

System Diagram

@lloydchang
Copy link
Contributor Author

lgtm

@lloydchang
Copy link
Contributor Author

:shipit: 🚢 🇮🇹

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 a pull request may close this issue.

3 participants