The Documentary Structure of Source Code. Van De Vanter, M. L. 44(13):767–782.
The Documentary Structure of Source Code [link]Paper  doi  abstract   bibtex   
Many tools designed to help programmers view and manipulate source code exploit the formal structure of the programming language. Language-based tools use information derived via linguistic analysis to offer services that are impractical for purely text-based tools. In order to be effective, however, language-based tools must be designed to account properly for the documentary structure of source code: a structure that is largely orthogonal to the linguistic but no less important. Documentary structure includes, in addition to the language text, all extra-lingual information added by programmers for the sole purpose of aiding the human reader: comments, white space, and choice of names. Largely ignored in the research literature, documentary structure occupies a central role in the practice of programming. An examination of the documentary structure of programs leads to a better understanding of requirements for tool architectures.
@article{vandevanterDocumentaryStructureSource2002,
  title = {The Documentary Structure of Source Code},
  author = {Van De Vanter, Michael L.},
  date = {2002-10},
  journaltitle = {Information and Software Technology},
  volume = {44},
  pages = {767--782},
  issn = {0950-5849},
  doi = {10.1016/s0950-5849(02)00103-9},
  url = {https://doi.org/10.1016/s0950-5849(02)00103-9},
  abstract = {Many tools designed to help programmers view and manipulate source code exploit the formal structure of the programming language. Language-based tools use information derived via linguistic analysis to offer services that are impractical for purely text-based tools. In order to be effective, however, language-based tools must be designed to account properly for the documentary structure of source code: a structure that is largely orthogonal to the linguistic but no less important. Documentary structure includes, in addition to the language text, all extra-lingual information added by programmers for the sole purpose of aiding the human reader: comments, white space, and choice of names. Largely ignored in the research literature, documentary structure occupies a central role in the practice of programming. An examination of the documentary structure of programs leads to a better understanding of requirements for tool architectures.},
  keywords = {*imported-from-citeulike-INRMM,~INRMM-MiD:c-13170998,~to-add-doi-URL,mathematical-reasoning,notation-as-a-tool-of-thought,programming,scientific-communication,software-engineering},
  number = {13}
}

Downloads: 0