Kengo TODA KengoTODA

Basis of modern web application architecture

Objective

Help a learner to grasp the basis of modern web application architecture
Help a team to share necessary contexts and definitions for communication

Table of context

Unix Philosophy

Understand comment and javadoc in 10 mins

Kengo TODA

Agenda

WHY COMMENT?
WHAT IS JAVADOC?

Positive, Negative, Critical, Pessimistic and Optimistic Thinking

Business person needs Positive Thinking and Critical Thinking. But sometimes we confuse them with Optimistic Thinking, Pessimistic Thinking and Negative Thinking. Leadership player understands the difference, and guide teammates to the right path.

Why leader is always positive

Problem Solving requests us to identify the gap between real and actual. So you'll find why the problem is still there.

Javadocでないコメントは、基本的に意図（WHY）を残すためのものだと思ってください。
意図以外の情報、例えば何をするものか・何が引数として必要か・どのような順番で
行うか、といった情報はすべてコードで表現できます。コメントは、これらでは補えない
意図を後に残すために使います。
なおコミットコメントも同様に意図を残すものですが、こちらは主に変更の意図を書くための
ものです。ただ、変更が大きい場合はコミットコメントに変更内容（WHAT）を書くこともあります。

Do NOT copy-paste javadoc. You should be responsible for your implementation.

	digraph "team and tech-practice" {
	compound=true;

	# Tech Practice (The Four Key Metrics)
	"Deployment Frequency" [shape=diamond]
	"Short Lead Time for Changes" [shape=diamond]
	"Short Time to Restore Service" [shape=diamond]
	"Low Change Failure Rate" [shape=diamond]

	# Tech Practice

	#!/usr/bin/env bash

	echo '# parallel, worker API, time [ms]'
	for (( i = 0; i < 1000; i++ )); do
	start_ms=$(ruby -e 'puts (Time.now.to_f * 1000).to_i')
	./gradlew --no-build-cache spotbugsMain > /dev/null
	if [ $? -eq 0 ]; then
	end_ms=$(ruby -e 'puts (Time.now.to_f * 1000).to_i')
	elapsed_ms=$((end_ms - start_ms))
	echo "false,false,${elapsed_ms}"

	* Where:
	Build file '/home/kengo/GitHub/spotbugs/spotbugs/build.gradle' line: 205

	* What went wrong:
	A problem occurred evaluating project ':spotbugs'.
	> Failed to apply plugin [id 'org.gradle.distribution']
	> DefaultDomainObjectSet#add(T) on [Signature spotbugs:jar.asc:asc:, Signature spotbugs:jar.asc:asc:javadoc, Signature spotbugs:jar.asc:asc:sources, Signature spotbugs:zip.asc:asc:] cannot be executed in the current context.

	buildScan {
	termsOfServiceUrl = "https://gradle.com/terms-of-service"
	termsOfServiceAgree = "no"
	}

	macOS Catalina 10.15.4 (19E287)
	openjdk 11.0.7

	macOS Catalina 10.15.4 (19E287)
	openjdk 11.0.7