# EntityTree: Exploring Product Entities EntityTree helps you explore the entities that make up your product model and see how they relate to one another. Use it when you need to understand a product area, trace relationships between entities, or locate a specific entity before reviewing its source context. ## Overview EntityTree presents product entities in a browsable hierarchy. It is designed to help you move from a broad product view to individual entities without needing to search through every repository or document manually. You can use the tree to explore product surfaces, user-facing flows, documentation topics, and other discovered entities. For example, the entity list may include items such as **Product Surfaces — what you actually have**, **User Flow**, or **Browse Repositories**. These entries provide a starting point for understanding how parts of the product are organized. EntityTree is especially useful during source and product intelligence work. Start with a known product concept, use **Search entities…** to narrow the list, and then review the entity’s relationships to understand how it connects to other parts of the product model. > 📷 _Screenshot pending: The EntityTree view showing the Product area, the Search entities… field, and a hierarchy of product entities._ ## Prerequisites Before you begin, make sure that: - You have access to the relevant Atloria project. - Product entities have been discovered or added to the project model. - You know a product term, screen name, user flow, or documentation topic you want to investigate. - You have permission to view product intelligence and source-related information where applicable. - You understand whether you are looking for a user-facing product entity or its supporting source context. ## Step-by-Step Instructions 1. Open the project where you want to explore the product model. 2. Select **Product** to work with product-focused entities rather than source-focused information. 3. Locate the **Search entities…** field above the entity list. 4. Enter a keyword that identifies the entity you want to find. 5. Review the filtered entity results shown in the tree. 6. Select an entity name to make it the focus of your exploration. 7. Expand the selected entity’s branch when an expansion control is available. 8. Review the child entities displayed beneath the selected entity. 9. Select a related entity in the branch to follow the relationship from one product concept to another. 10. Continue expanding related entries until you reach the level of detail you need. 11. Use **View Source** when you need to compare the product entity with its available source context. 12. Select **Source** to switch your attention from the product model to the related source-oriented view. 13. Return to **Product** when you want to continue exploring product relationships. 14. Select **User Docs** when the entity relates to user documentation or a user-facing manual topic. 15. Select **📋 User Manuals** when you want to locate user-manual content associated with the product area you are exploring. > 📷 _Screenshot pending: A user entering a term in Search entities… and expanding matching entities to review related product concepts._ ### Example: Explore a repository browsing flow 1. Enter `Browse` in **Search entities…**. 2. Select **Browse Repositories** from the matching results. 3. Expand the entity branch to review related entries. 4. Select **Browse Repos** if it appears as a related entity or alternate product label. 5. Select **3. Repo Browser** to examine the product area associated with repository browsing. 6. Select **User Flow** to understand the flow-oriented context connected to the repository browsing experience. 7. Select **View Source** if you need to investigate supporting source information for the selected product entity. > 📷 _Screenshot pending: The EntityTree filtered for Browse, with Browse Repositories, Browse Repos, and 3. Repo Browser visible in the relationship hierarchy._ ## Tips and Best Practices - Start with the most specific term you know. Searching for a screen or feature name, such as **Repo Browser**, usually produces more focused results than a broad term such as “product.” - Try alternate names when an entity does not appear immediately. A concept may be represented with a user-facing label, a shorter label, or a broader product-area name. For example, **Browse Repositories** and **Browse Repos** may both be useful search terms. - Explore both parent and child entries. A parent entity gives you context for where an item belongs, while child entities can reveal more detailed product concepts and supporting relationships. - Treat relationships as navigation paths, not just a list. If an entity leads to **User Flow**, use that connection to understand the user journey. If it leads to documentation topics, use **User Docs** or **📋 User Manuals** to investigate the user-facing guidance. - Use **Product** and **Source** together when needed. The **Product** view helps you understand what users experience; **Source** helps you investigate the available implementation context. Switching between them can clarify whether two similarly named entities refer to the same product capability. - Search for documentation-oriented entities when researching product guidance. Entries such as **Product Surfaces — what you actually have** or **Lane ③ — User manuals / help centers / KBs** can help you identify relevant manual and help-center coverage. ## Related Pages - [Browsing Repositories](#) - [Using Source Intelligence](#) - [Viewing Entity Source Context](#) - [Understanding User Flows](#) - [Finding User Manual Content](#) - [Product Surfaces and Product Model Discovery](#) ## Troubleshooting ### No entities appear after searching 1. Clear the text in **Search entities…**. 2. Enter a shorter or alternate keyword. 3. Try a related product term, such as **Product**, **User Flow**, or **Source**. 4. Confirm that you are working in the correct project. ### The entity I found does not show the relationship I expected 1. Expand the entity’s available branch. 2. Select its parent entity to review the broader context. 3. Select related child entities to follow adjacent product concepts. 4. Use **View Source** to review source context when the product relationship alone is not enough to explain the connection. ### I cannot tell whether I should use Product or Source 1. Select **Product** when you want to understand screens, product areas, user flows, or documentation-facing concepts. 2. Select **Source** when you need to investigate the available source context for an entity. 3. Return to **Product** after reviewing source information to continue mapping the entity’s product relationships.