The Documentary Structure of Source Code. Van De Vanter, M. L. 44(13):767–782. 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
{"_id":"HxKjYZ8D4HMoJyZDC","bibbaseid":"vandevanter-thedocumentarystructureofsourcecode","authorIDs":[],"author_short":["Van De Vanter, M. L."],"bibdata":{"bibtype":"article","type":"article","title":"The Documentary Structure of Source Code","author":[{"propositions":[],"lastnames":["Van","De","Vanter"],"firstnames":["Michael","L."],"suffixes":[]}],"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","bibtex":"@article{vandevanterDocumentaryStructureSource2002,\n title = {The Documentary Structure of Source Code},\n author = {Van De Vanter, Michael L.},\n date = {2002-10},\n journaltitle = {Information and Software Technology},\n volume = {44},\n pages = {767--782},\n issn = {0950-5849},\n doi = {10.1016/s0950-5849(02)00103-9},\n url = {https://doi.org/10.1016/s0950-5849(02)00103-9},\n 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.},\n 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},\n number = {13}\n}\n\n","author_short":["Van De Vanter, M. L."],"key":"vandevanterDocumentaryStructureSource2002","id":"vandevanterDocumentaryStructureSource2002","bibbaseid":"vandevanter-thedocumentarystructureofsourcecode","role":"author","urls":{"Paper":"https://doi.org/10.1016/s0950-5849(02)00103-9"},"keyword":["*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"],"downloads":0},"bibtype":"article","biburl":"https://tmpfiles.org/dl/58794/INRMM.bib","creationDate":"2020-07-02T22:41:32.072Z","downloads":0,"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"],"search_terms":["documentary","structure","source","code","van de vanter"],"title":"The Documentary Structure of Source Code","year":null,"dataSources":["DXuKbcZTirdigFKPF"]}