add description of file inclusion; fix typos; add description of file inclusion in JSON