# How to Use the Tutorial

The JNDI Tutorial is an online guide to writing directory-enabled programs in the Java programming language.

This tutorial is modeled after The Java Tutorial, by Mary Campione and Kathy Walrath. The following description is an excerpt from The Java Tutorial, with minor substitutions made to refer to the trails in the JNDI tutorial.

#### Documentation Trails

> The tutorial consists of a series of intersecting trails -- programming lessons grouped together by topic. To learn about a certain topic, go to the Trail Map, decide which trail is of interest to you, and follow the link to the trail head for that trail. For example, if you are interested in information about writing a service provider, select the link to the Building a Service Provider trail, marked with this signpost:

> The trail head is the first page on a trail. It lists, describes, and provides links to all of the lessons on the trail. Selecting a link from the trail head takes you to the lesson head for the lesson that you chose. The lesson head is the first page in the lesson and introduces the lesson, typically providing an outline or overview of the lesson. Usually, several lesson pages comprise the entire lesson.

#### The Control Panel

> Each page in The JNDI Tutorial has a control panel at the top with the following five elements:

> | The "Previous" link takes you to the previous page in the lesson.
> | The "Next" link takes you to the next page in the lesson.
> | This link transports you to the top of the tutorial: to the Trail Map.
> | This is a trail marker and is a link to the trail head of the current trail. Each trail has its own identifying trail marker--the symbol to the left represents the Building a Service Provider trail.
> Lesson Title | And finally, this right-aligned link is the title of the current lesson and is linked to the lesson head (the first page in the lesson) of the current lesson.

#### Inline Links

> Links within the text of the tutorial have one of the following forms:
> - Links to pages within the current lesson are text links.
> - Links to pages within a different lesson, but on the same trail as the current lesson are also text links , but they include the trail icon. Both the text and the icon are links.
> - Links to pages in a different trail are also text links , but they include an icon that indicates which trail the lesson is on. Both the text and the icon are links.
> - Links to API documentation (javadoc) are also text links . They have an icon that indicates that the reference is to the API documentation rather than a page within the tutorial.