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

Mental models: What things are you need to understand when you're reading code? #3

Open
carlogilmar opened this issue Apr 24, 2024 · 0 comments
Labels
documentation Improvements or additions to documentation

Comments

@carlogilmar
Copy link
Member

carlogilmar commented Apr 24, 2024

Reading Elixir Code

documentation

When you're on a new project you need to read code to understand what's happening. This involves many time trying to understand the big picture about the project. Based on the Programmer's Brain, we need mental models to understand code abstractions, ex_plain is a tool to visualize, instead of software diagrams, mental models to boots our understanding.

Mental Model: Technical representation about a piece of code.

Basic mental models for elixir systems:

Mental Models for read Elixir Code

  1. Module Backbone: Show all the functions public and private available in a module.-
  2. Function Structure: Show all the functions used in a function.
  3. Function Usage: Show all the modules and functions we're the function is being used.
  4. Function Data Flow: Show how an input transforms into a output in a function.

Click to see the source

@carlogilmar carlogilmar added the documentation Improvements or additions to documentation label Apr 24, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

No branches or pull requests

1 participant