RFC 544 UNKNOWN DOCUMENTATION · SRI-ARC · NLS

Locating on-line documentation at SRI-ARC

Where to find documentation in the NLS system.

On rfc-editor.org ↗
PUBLISHED
July 1973
AUTHORS
N.D. Meyer, K. Kelley
STREAM
Legacy
SYSTEM
NLS (oN-Line System)
LOCATION
SRI-ARC (Stanford Research Institute)
FILES
NIC LOCATOR and ARC LOCATOR
DOI
10.17487/RFC0544

RFC text

Original text · RFC Editor View on rfc-editor.org ↗
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
PROBLEMSRI-ARC's NLS (oN-Line System) hosted much of the ARPANET's documentation, but users had difficulty locating the information they needed among the many available files.
MECHANISMTwo structured files were created to guide users to documentation through a system of links and branch references: the NIC LOCATOR file for general network documentation, and the ARCLOCATOR file for SRI-ARC system documentation.
DISCOVERY TOOLThe locator files became the primary way ARPANET users discovered and accessed documentation at SRI-ARC.

§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.