Creating Diagrams and Documentation
To see Together in action, we are going to walk through a common scenario where you might want to use the product. Most structured development projects will utilise "Use Cases" to document the application and how it will be used. Previously, developers were always stuck drawing these use case diagrams by hand or using a diagramming tool like Visio. With Borland Together you can create these diagrams within Visual Studio and have the required documentation automatically generated for you. In this walk through we are going to create a simple use case diagram and then generate the documentation for our development project.

To get started, download and install the demo version of Borland Together from the Borland web site and open or create a new project within Visual Studio.NET. From that point, follow these steps:

1. Select View > Together VS.NET Model View
2. Right-click on the name of the application and from the right-click menu and select Add > Other Diagram to open the dialog shown below:
   
   Figure 3: Diagram options

3. Enter a name for your diagram and click OK. This will open the blank use case diagram.
4. From the Toolbar on the left-hand side, drag an actor onto the page and label it "Administrator"
5. Next, drag a use case "bubble" from the Toolbar and label it "Enter and verify opening balances"
6. Finally, drag another actor onto your diagram and label it "Accountant"
7. To join the actors to the use case, drag a communications link between them, as shown below in Figure 4.
   
   Figure 4: A simple use case

8. Now that your use case is finished, you can now auto-generate the documentation for your project. In this example, we haven't included any code but if you did have code in your project that would be documented as well.