diegofhe/guidelines

General styleguides & documentation for modern product development

Product Development Guidelines

My personal & professional bookmarks, guidelines & documentation for modern product development

---

Engineering

🏗 DevOps

Git

• PRs (Pull Requests)
• Semantic Commits
• Git Workflow (basic)
• Gitflow: A successful Git branching model
• Git Tools - Rewriting History

Code Reviews

• Why review code?
• How to Do Code Reviews Like a Human (Part One)
  • Part Two
• How to do a code review
• More Effective Code Reviews
• The (written) unwritten guide to pull requests
• Pull requests and code review

Heroku

• CLI
• Postgres
• Rollbacks

⚙️ Backend

Ruby (on Rails)

• Ruby Styleguide
  • Rubocop Styleguide

Best Practices & Design Patterns

Service Objects

• A simple explanation of Service Objects for Ruby on Rails
• Using Services to Keep Your Rails Controllers Clean and DRY
• Rails Service Objects: A Comprehensive Guide

Controllers

• Memoizing
  • Explaining the rationale behind using memoized helper methods for controller resources
  • The Basics of Ruby Memoization
  • Rails best practices: Use memoization
  • 4 Simple Memoization Patterns in Ruby (And One Gem)

Testing

• How to configure RSpec in Ruby on Rails

Migrations

• Data Migrations
  • Data Migrations in Rails
  • Migrating Data - Rails Migrations or a Rake Task?

REST APIs

Specifications

• JSON:API

🖼 Frontend

Javascript

HTML & CSS

• Grid Layout
  • Grid by Example
  • Learn CSS Grid

React

• Thinking in React
• Presentational and Container Components (Dan Abramov)
  • Example Gist (Michael Chan)
  • Usage with Redux
• React Cheat Sheet
• React Patterns
• How to fetch data in React

CSS-Modules

• CSS Modules
• CRA: Adding CSS Modules
• Getting started with CSS modules in React
• What are CSS Modules and why do we need them?
• What are CSS Modules? A visual introduction

State Management

• Hooks & Context API
  • Application State Management with React
  • State Management with React Hooks and Context API in 10 lines of code!
• MobX
  • Ten minute introduction to MobX and React
  • MobX: Concepts & Principles
  • Video: Preethi Kasireddy - MobX vs Redux: Comparing the Opposing Paradigms - React Conf 2017
  • Building a JSON:API App with React and Reststate/Mobx Redux
• Redux (react-redux)
  • Leveling Up with React: Redux
  • React Redux Tutorial for Beginners: The Definitive Guide (2019)
  • Redux and React: An Introduction
  • What Does Redux Do? (and when should you use it?)
  • How Redux Works: A Counter-Example
  • Redux Architecture and Best Practices
  • Redux Ecosystem Links
  • JSON:API resources for React + Redux

Testing

• Write tests. Not too many. Mostly integration.
• Jest
  • jest-dom
• RTL (react-testing-library)
  • testing-library/react-testing-library
  • React Testing Examples: Jest + RTL
  • Course: Teting Javascript by Kent C. Dodds
• Enzyme (AirBnB)

⭐️ Misc

• DockYard Styleguides
• Airbnb JavaScript Style Guide
• Tractical Guides

📚 Books

Technical

• Refactoring (Martin Fowler)
• The Pragmatic Programmer
• Domain-Driven Design (Eric Evans)
• Domain-Driven Design Distilled
• Patterns of Enterprise Application Architecture (Martin Fowler)
• JavaScript: The Good Parts (Douglas Crockford)
• You Don't Know JS (Kyle Simpson)

Non-technical

• The Lean Startup (Eric Ries)
• Inspired: How to Create Tech Products Customers Love
• Zero to One: Notes on Startups, or How to Build the Future (Peter Thiel)
• High Output Management (Andrew S. Grove)
• Remote (J. Fried, D.H.H.)
• Rework (J. Fried, D.H.H.)
• Priming Kanban