現在、正式な調査レポートを作成しており、このレポートにコードを含める予定です。
質問:調査レポートにコードを表示する方法として認められているものはありますか? フォント、スペースなどの点と、コードをドキュメント内に表示するか、付録に表示するかの両方について考えています。
コードは JavaScript と PHP になります。コードのどのセクションも 25 行を超えることはありません (したがって、これらは単なるスニペットです)。約半ダースのスニペットがあります。各スニペットには、コードで何が起こっているかを説明するいくつかの段落と、その長所/短所に関する議論があります。
私は報告書の提出先の組織と連絡を取り合っておらず、コードのフォーマット方法に関するガイドラインも公開していません (これらの点について質問しないでください)。