Locating on-line documentation at SRI-ARC
Where to find documentation in the NLS system.
Meyer, N.D. and K. Kelley, "Locating on-line documentation at SRI-ARC", RFC 544, DOI 10.17487/RFC0544, July 1973, <https://www.rfc-editor.org/info/rfc544>.
@misc{rfc544,
series = {Request for Comments},
number = 544,
howpublished = {RFC 544},
publisher = {RFC Editor},
doi = {10.17487/RFC0544},
url = {https://www.rfc-editor.org/info/rfc544},
author = {N.D. Meyer and K. Kelley},
title = {{Locating on-line documentation at SRI-ARC}},
pagetotal = 1,
year = 1973,
month = jul,
} RFC text
Network Working Group Dean Meyer (SRI-ARC)
RFC # 544 Kirk Kelley (SRI-ARC)
NIC # 17782 July 13, 1973
Locating On-Line Documentation at SRI-ARC
Where there used to be one, there are now two files to help users locate
user documentation and other files available in NLS:
<NIC>LOCATOR will lead the user to NIC functional documents by means
of links. Its branch labeled "ARC SYSTEM DOCUMENTATION" will direct
the user to <USERGUIDES>ARCLOCATOR.
(nic, locator, l:w)
<USERGUIDES>ARCLOCATOR includes documentation of the SRI-ARC system.
Many ARC features are available for Network use, and the documents
in <USERGUIDES>ARCLOCATOR should serve to introduce users to these
capabilities.
(userguides, arclocator, l:w)
These files are formatted in a way that allows the documents to be
easily accessed by inexperienced NLS users. Both files contain
instructions for their use as branch one. To see these instructions:
L[oad] F[ile] <nic>locator CR
P[rint] B[ranch] .1 CA wn CA
Please send ideas and suggestions for the LOCATOR files to KIRK or NDM
at SRI-ARC.
[ This RFC was put into machine readable form for entry ]
[ into the online RFC archives by Alex McKenzie with ]
[ support from GTE, formerly BBN Corp. 10/99 ]
AI ELI5
On this page
§1Organizing ARPANET Documentation
SRI-ARC, the Stanford Research Institute's Augmentation Research Center, hosted much of the ARPANET's distributed documentation in its NLS (oN-Line System), an innovative hypertext-like environment that supported linked documents and structured browsing. As the collection grew, users needed help locating the specific documents they sought.
To address this, SRI-ARC created two locator files to serve as navigational guides: the NIC LOCATOR for general network documentation and the ARC LOCATOR for system-specific documentation.
One computer had lots of instruction manuals stored in it, so two librarians made two maps to help people find what they wanted.
§2The NIC and ARC Locator Files
The NIC LOCATOR file was the primary entry point for users seeking network-wide documentation. It organized functional documents through a system of branches (hierarchical document sections) that could be followed to find information about different topics. A branch labeled "ARC SYSTEM DOCUMENTATION" within the NIC LOCATOR directed users to the ARCLOCATOR file.
The ARCLOCATOR file contained documentation specific to the SRI-ARC system itself, introducing users to the many features available for network use and explaining how to use the various ARC capabilities. Both files were formatted in a way that was accessible to inexperienced NLS users, with instructions on how to use the files themselves included as the first branch (branch .1).
One file had links pointing to different topics. If you wanted to learn about the SRI-ARC computer system, that file had a link to another file that explained it all.
§3Using the Locator Files
To access the NIC LOCATOR, users would load the file using the NLS command: L[oad] F[ile] [NIC]locator CR. Once loaded, users could display the instructions (in branch .1) by typing P[rint] B[ranch] .1 CA wn CA. These commands and the structured branch system made navigation straightforward for users who were familiar with NLS commands.
Users were invited to send suggestions and improvements for the LOCATOR files to Kirk Kelley or NDM (Dean Meyer) at SRI-ARC. This feedback mechanism helped keep the documentation guides current as the network and its documentation collection evolved.
You typed commands to load the map file, then you could jump to different sections to find what you were looking for. If you had ideas for making it better, you could send a message to the people who built it.