コメントに類似のもの.
コンピュータ言語のソースコード以外のデータを扱うアプリケーションソフトウェアでも、コメント同様の機能が利用できる場合がある。ワードプロセッサソフトや表計算ソフトにおける「コメント」あるいは「付箋」などの機能が該当する。
備考.
オープンソース／クローズドソースを問わず、コメントはプログラムの共同開発やソースコードの保守管理に欠かせないものである。特にプログラム内にコメントによるドキュメントを含ませることで、チームを組んで共同作業したり保守したりするうえで役立つ。また、担当者が変わった後でも保守・改良、またはバグ修正に大きな力を発揮する。ただし、それは「正しいコメントが記述されている」という前提の話である。間違ったコメントが書かれている場合、解読を妨げたり誤解を生んだりする原因にもなる。
コメントの良し悪しは、読者の前提知識や主観もかかわってくるので、どのようなコメントが適切であるかは一概には述べることができない。プログラムコードの各ステップ行で何を実行しているかを自然言語によって逐一説明するようなコメントは、「冗長である」「記憶領域を無駄に浪費する」「読みづらくなる」などの短所をはらむ可能性もあるが、初心者や入門者向けのサンプルコードとしては役に立つこともある。
プログラムコードの本文を読めば、「何を実行しているか」自体は分かるため、コメントには「何を実行しているか」を記述するよりも、「なぜそのようなコードを書いたのか」という設計理由を記述するべきである、という方法論もある。
とき (列車)
本項では、上越新幹線で運転されていた列車および、首都圏と新潟県を結んでいた優等列車の沿革についても記述する。
概要.
列車名の由来.
「とき」は列車の運転開始当時、すでに特別天然記念物・国際保護鳥に指定されていた、佐渡島のトキ（朱鷺）にちなんだものである。新潟県内で親しまれていた列車名であったことから、地域に密着した列車となることを目指して命名されている。
「あさひ」は「朝昇る太陽」の明るいイメージがあり、初の列島横断新幹線である上越新幹線が日本海側に明るい光をもたらし、速達列車にふさわしいとして名付けられた。なお「べにばな」に改称した方の在来線の「あさひ」は、山形県の「朝日岳」にちなむ。
運行概況.
停車駅.
使用車両・編成.