Gen Tamura gentamura

技術文書の書き方

このメモは、私（@ymmt2005）が長年にわたってソフトウェアプロダクト開発に関わってきて 2022年現在こうしたほうが良いと考えているベストプラクティスです。

科学的な分析等に基づくわけではない経験則であるため、今後も随時見直すことがありますし、ここに書いてあることが常に正しいわけでもあらゆるソフトウェア開発に適するわけでもありません。

しかしながら、実務経験が豊富で、モダンな技術スタックに明るいエンジニアの経験則は一定の役に立つのではないかと考えて記します。

Frontend Study 用

DB を持たないため、表層の技術を交換するだけで済む
- JSON API が実質的な分解点になっている
- 近年ではモバイルアプリのために JSON API が切り離されていることが多く、ここの利用者になるだけでよい
Rails や PHP で ORM ヘルパーにべったりな場合に困難になる(クライアントで同等のバリデーションを再現する必要)

The following descriptions are or will soon be no longer useful; I suggest using the new official API.

float32
float64
int
int8
int16
int32
int64

n番煎じの話題。今更な話題、それはわかってる。自分の周りの環境が変わったので、書き下すことで、再度整理したい。

サーバーが生成するHTMLが一つの粘土の像だとしたら、jQueryがナイフで、Reactは設計図を持った3Dプリンタ。

鼻が大きすぎるから削るとか、ちょっとしたことをやるのが jQuery の主な用途。しかしあるいは、職人的に、大きな塑像から、一つの像を切り出すこともできる。

概要

概要

	import { cache } from "react";

	import DataLoader from "dataloader";

	// backend service clients
	import { getPopularPosts, getUserById, getUsers } from "@/services";

	const memoizedGetUserById = cache(getUserById);

	const getUserLoader = () =>

	// SPDX-License-Identifier: MIT
	pragma solidity ^0.8.4;

	import "@openzeppelin/contracts/utils/Counters.sol";
	import "@openzeppelin/contracts/token/ERC721/extensions/ERC721URIStorage.sol";
	import "@openzeppelin/contracts/token/ERC721/ERC721.sol";

	import "hardhat/console.sol";

	contract NFTMarketplace is ERC721URIStorage {