How to Document Wisely
�l���͒Z���ĒN���ǂ܂Ȃ����炢�̂��Ƃ������Ă����B���Ȃ������킲�Ƃ������Ȃ��A�N���������ǂ܂Ȃ��ł��傤�B���������āA�����ǂ��h�L�������g���œK�ł��B�}�l�[�W���[�͂����𗝉����Ă��Ȃ����Ƃ��悭�����܂��B�Ȃ��Ȃ��A�������h�L�������e�[�V�����ł����Ă��A�ނ炪�v���O���}�[�Ɉˑ����Ă��Ȃ��Ƃ����������Z�L�����e�B���o���^���邩���ł��B�N�����{���ɖ��ɗ����Ȃ������������Ă����ƒf�����Ă����ꍇ�́A�u�͂��v�ƌ����ĐÂ��Ɏd�����T���n�߂��B
�h�L�������g�̎��v���ɘa���邽�߂ɁA�K�ȃh�L�������g�����ς����ɑg�ݍ��ނ̂ɂ����鎞�Ԃ𐳊m�Ɍ��ς��邱�Ƃ́A�����قnj��ʓI�ł͂����܂����B�^���͊����ē���F�e�X�g�̂悤�ȃh�L�������g�́A�R�[�h���J���������������{�����������邱�Ƃ������܂��B
�ǂ��������������Ƃ́A�܂������ɁA�ǂ��������ł��B���͂��Ȃ������M�A���A���K�Ɋւ����{�����‚��邱�Ƃ������߂��܂��B�������A���Ƃ����Ȃ����ڗ��ȍ��Ƃł����Ă��A���Ȃ������������Ȃ����Ȃ��Ȃ����t�̕n���Ȗ��߂������Ă��Ă��A�����̃��[���͖{���ɕK�v�Ȃ��̂ł��F�u���Ȃ����ނ��ɂ��Ȃ��̂��Ƃ��������悤�ɁA���l�ɍs���܂��B�N�����Ȃ��̏��ނ��ǂ��ł����̂��A�������甲���o���K�v�������̂�??�A�ǂ̂悤�ɂ������������邱�Ƃ��ł����̂����l���Ă��������B���������Ȃ��A���Ȃ��͕��ϓI�ȃh�L�������e�[�V�������C�^�[�ł����A�ǂ��v���O���}�[�ɂȂ��ł��傤�B
�v���O���}�[�ȊO�̐l�����ۂɓǂނ��Ƃ��ł��镶�����쐬�����̂ł͂Ȃ��A���ۂɃR�[�h���̂������邱�ƂɊւ��ẮA�������܂łɒm���Ă����ō��̃v���O���}�[�͕��ՓI�Ȋ����������Ă��܂��F�����̃R�[�h�������āA�R�[�h���̂��������Ƃł͂����肳���邱�Ƃ͂ł��܂����B�����ɂ́A2�‚̗��R�������܂��B�܂��A�R�[�h���x���̃h�L�������g���Q�Ƃ����K�v�������l�́A�قƂ��ǂ̏ꍇ�A�R�[�h���ǂ߂��悤�ɂȂ��܂��B�m���ɁA�����͏��S�҂������o���L�x�ȃv���O���}�[�ɂƂ��Ă͊ȒP�ł��B�������A�����ɏd�v�Ȃ̂́A�������Ȃ����A�R�[�h�ƕ����͖������Ă��Ȃ��Ƃ������Ƃł��B�ň��̏ꍇ�A�\�[�X�R�[�h�͊Ԉ����č��������”\���������܂��B���S�ɏ������Ă��Ȃ����A���̕����͂������‚����Ƃ��ł��A�����͉����{���������܂��B
�����͐ӔC�����v���O���}�[�ɂƂ��Ă����ȒP�ɂ͂Ȃ��܂����B�����̃R�[�h���ǂ̂悤�ɏ����̂ł����H�����͂ǂ������Ӗ��ł����H���̈Ӗ��́F
�N�����������ǂޕK�v�����邱�Ƃ��m���Ă����R�[�h�������B
- �S�[���f�����[�����K�p�����B
- �ʂ̃\�����[�V�������v���ɗ��p�ł����ꍇ�ł��A�ȒP�ȃ\�����[�V�������I�������B
- �R�[�h�����lj����鏬���ȍœK�����]���ɂ����B
- �ǎ҂̂��Ƃ��l���āA�ޏ��������Ɗy�ɂ����M�d�Ȏ��Ԃ����₵�Ă��������B������
foo�Abar�AdoIt�̂悤�Ȋ������g�p���邱�Ƃ͂����܂����I