JSON Schemaを用いた各種ライブラリやMarkdown生成ツールなどが出てきているが、実際に運用しようとしたときに試行錯誤し、最終的に落ち着きそうな形が見えてきたので共有したい。 良さそうな書き方 ファイルを分割しない。するならHyperSchemaファイルごとに JSON (Hyper)Schemaファイルを書くと一瞬で行数が巨大化する。 そのため現状では、各Schemaファイルをツールにより結合して巨大な一枚のファイルに結合する方法があり、prmdが用いられているのをよく見る。 ただこれにはいくつか問題があり、 結合後のSchemaにより発生したエラーを追いにくい 各ファイルで定義されたSchemaを参照する際に、エディタなどの補助がなければ辛い をどうするかという話が出てくる。 全体を一枚のファイルで書くと、極めて原始的だが、参照性の問題や、 結合の方法が原因のエラーを考えな