coprolit

A guide to Pull Request Descriptions

There’s a Pull Request on the software that you and your team are responsible for, and before you start reading all the changes, you’ve no idea what it is about...
You’ve no idea what the author’s intent of the change is.
You don’t know why the changes are being made.
You don’t know if the author wants you to do an in-depth review, or just wants a token approval.

Sounds familiar?

When you create a Pull Request, please make these things clear to the reviewers.

coprolit

Promises & Observables

A short comparison of Promises and Observables in JavaScript

Table of contents

• Terminology
• What does it do?
• Differences
  • Multiple values
  • Eager vs Lazy
• Data transformation

coprolit

A few guidelines for sustainable software

• Favor decoupled over DRY.

• Favor declarative programming (functional and reactive) over imperative programming.

• Favor composition over inheritance (organize by function, instead of type).

• Share interfaces, not implementation.

• Separate code into stateful and stateless interactions.

• Whenever possible, use stateless building blocks and push side-effects to the edges of the application.

• Favor pure functions (pure function > function > factory > class).

coprolit

Design patterns for sustainable front-end architecture

A quick summary of some best practices for developing a front-end architecture of modular, loosely coupled and highly composable building blocks, to create codebases that are as scalable, reusable, flexible and maintainable as possible.

• Goal
• Design Patterns and techniques
  • Modular programming
  • Declarative programming
  • (Purely) Functional programming
  • Unidirectional data flow
• Observer pattern

coprolit

<div id="app"></div>

coprolit

/**
 * A common interface for Authentication logic.
 * Handling login, logout, and refresh token.
**/

import { Tokens, ApiError } from '@/models/api';
import { http, token } from "./";

export async function login(email: string, password: string): Promise<void> {
  const result: Tokens | ApiError = await http.post(

coprolit

// Pipelines
// A pipeline allows for easy function composition when performing multiple, immutable operations on a variable.

const pipe = functions => data => {
  return functions.reduce(
    (value, func) => func(value),
    data
  );
};

coprolit

// Using object literal:
function getStatusColor (status) {
  return {
    success: 'green',
    warning: 'yellow',
    info: 'blue',
    error: 'red'
  }[status]
}

coprolit

// GitHub window.fetch polyfill: https://github.com/github/fetch

// basic GET request:
fetch("/data.json").then(function(res) {
  // res instanceof Response == true.
  if (res.ok) {
    res.json().then(function(data) {
      console.log(data.entries);
    });
  } else {

coprolit

// Each of the following options will create a new empty object:

var newObject = {};

// or
var newObject = Object.create( Object.prototype );

// or
var newObject = new Object();