Mihara Tomonari tm8r

name

japanese-tech-writing

description

日本語の技術文書・書籍原稿の文章規範。整形（一文一行、引用ブロック、脚注、コラム記法）、段落と論証の構成（パラグラフライティング）、論証の厳密さ（ツッコミどころの除去）、読み手の負荷の管理、視点と語り、演出の抑制、LLM っぽい空句の禁止、冗長の排除を定める。日本語で技術書の章、草稿、記事、解説文を書くとき、または推敲・リライトするときに使用する。

日本語技術文書の文章規範

日本語で技術的な原稿（書籍の章、記事、解説文）を書く・推敲するときは、以下の規範に従う。

整形

コマンドによる「負荷」の原因切り分け

この文章では、Linuxコマンド、sar, top, psを使って、一般的に負荷といわれるものの原因を切り分けることを目的とする。

そもそも負荷とは

「複数のタスクによるサーバリソースの奪い合いの結果に生じる待ち時間」を一言で表した言葉。OSのチューニングとは負荷の原因を知り、それを取り除くことにほかならない。

ボトルネックの見極め作業の大まかな流れ

ロードアベレージ（処理を実行したくても、実行できなくて待たされているプロセス（CPUの実行権限が与えられるのを待っている、またはディスクI/Oが完了するのを待っている）の数）を見る

	'''
	Template class for docking a Qt widget to maya 2017+.
	Author: Lior ben horin
	12-1-2017
	'''

	import weakref

	import maya.cmds as cmds
	import maya.OpenMayaUI as omui

	# coding: utf-8
	u"""
	Maya 2017 workspaceControl の問題回避のサンプル。

	workspaceControl と workspaceControlState のゴミが残らないようにする。

	retain=False の場合でも何故か state のゴミが残ってしまうが、
	scriptJob で workspaceControl の削除を監視して state も同時に削除するようにする。

	retain=True の場合は、UI が閉じたとしても state は残って良いはずなので監視はしない。

	#!/usr/bin/env mayapy

	import itertools
	import math
	import random
	import timeit

	from maya import cmds, OpenMaya, OpenMayaAnim

	"""
	This is what you need to do in order to get a qt window to dock next to maya channel box,
	In all maya versions, including 2017 with PySide2
	"""
	__author__ = "liorbenhorin@gmail.com"

	import sys
	import os
	import logging
	import xml.etree.ElementTree as xml

	# Relies on https://github.com/christophercrouzet/banana.maya

	import collections
	import json

	from maya import OpenMaya, OpenMayaAnim, cmds

	import banana.maya
	banana.maya.patch()