rooftop-media / rooftop-media.org-tutorial

Step-by-step documentation for how rooftop-media.org is built.
Creative Commons Zero v1.0 Universal
0 stars 0 forks source link

Refactor server code & tutorial to be easy to describe & memorize #52

Open benholland1024 opened 1 year ago

benholland1024 commented 1 year ago

This issue deals with human cognition as much as code style probably.

What makes code easy to describe & memorize?

benholland1024 commented 1 year ago

When server.js recieves a new HTTP request, here's what might happen:

benholland1024 commented 1 year ago

The list above is memorizable.

There are some other functions that need to be added, to "factor out" functionality of the list's functions. For example, inserting a page into index.html, or responding to a API request.

It's always going to take some time to describe.
The goal is a description that makes sense consistently and efficiently. (And code that works!)