Discover gists

Code is clean if it can be understood easily – by everyone on the team. Clean code can be read and enhanced by a developer other than its original author. With understandability comes readability, changeability, extensibility and maintainability.

General rules

Follow standard conventions.
Keep it simple stupid. Simpler is always better. Reduce complexity as much as possible.
Boy scout rule. Leave the campground cleaner than you found it.
Always find root cause. Always look for the root cause of a problem.

Design rules

Installing Fish shell on MacOS

Fish is a smart and user-friendly command line (like bash or zsh). This is how you can nstall it on MacOS and make your defaul shell.

Note that you need the https://brew.sh/ package manager.

You can also download the fish app from their website. I do recomand using brew because update are easier.

Install Fish

Playbook: Creating a GitHub Integration Plugin for Backstage

Overview

This playbook outlines the steps to create a plugin for Backstage that integrates with GitHub to do user specified tasks.

What's Needed From User

GitHub repository URL.
Access token with appropriate permissions for accessing the repository.

	<!DOCTYPE html>
	<html lang="en">
	<head>
	<meta charset="UTF-8">
	<meta name="viewport" content="width=device-width, initial-scale=1.0">
	<title>2D Platformer Game</title>
	<style>
	canvas {
	border: 1px solid black;
	display: block;

	import plistlib
	import struct
	import logging
	import lief
	import sys
	from typing import List
	from macholib import MachO, mach_o

	logger = logging.getLogger(__name__)

	'use server';

	export const signUpAction = apiAction(
	signUpFormSchema,
	async (data): Promise<{ }> => {
	// ...
	},
	);

	# This code is licensed under the terms of the MIT license https://opensource.org/license/mit
	# Copyright (c) 2021 Marat Reymers

	## Golden config for golangci-lint v1.58.0
	#
	# This is the best config for golangci-lint based on my experience and opinion.
	# It is very strict, but not extremely strict.
	# Feel free to adapt and change it for your needs.

	run: