> ## Documentation Index
> Fetch the complete documentation index at: https://docs.skillbridgedev.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Topics & Knowledge Organization

> Create hierarchical topic structures and organize knowledge using concepts, people, events, and academic domains

# Topics & Knowledge Organization

The Topics system in SkillShop Client enables you to create sophisticated knowledge hierarchies that organize educational content using multiple categorization approaches including concepts, people, events, and academic domains.

## Topic Categories

SkillShop organizes knowledge into five distinct category types:

<CardGroup cols={2}>
  <Card title="Concepts" icon="lightbulb">
    Abstract ideas, theories, and principles that form the foundation of academic understanding.
  </Card>

  <Card title="People" icon="user">
    Individuals of historical, cultural, or academic significance who have contributed to various fields of knowledge.
  </Card>

  <Card title="Events" icon="calendar">
    Historical occurrences, milestones, and significant happenings that shape understanding of time and causation.
  </Card>

  <Card title="Academic Domains" icon="graduation-cap">
    Major fields of study and broad disciplinary areas that encompass related knowledge areas.
  </Card>

  <Card title="Subdomains" icon="sitemap">
    Specialized areas within broader academic domains that focus on specific aspects of a field.
  </Card>
</CardGroup>

## Creating Topic Hierarchies

<Steps>
  <Step title="Access Topics Section">
    Navigate to **Topics** in the main menu to access the topic management interface.
  </Step>

  <Step title="Create Parent Topics">
    Start with broad, high-level topics:

    <Tabs>
      <Tab title="Academic Domains">
        Create major subject areas:

        * Mathematics
        * Science
        * History
        * Literature
        * Arts
      </Tab>

      <Tab title="Conceptual Areas">
        Define broad conceptual categories:

        * Scientific Method
        * Democratic Principles
        * Mathematical Reasoning
        * Literary Analysis
      </Tab>
    </Tabs>
  </Step>

  <Step title="Build Hierarchical Structure">
    Create child topics under parent categories:

    ```
    📚 Mathematics (Domain)
      📐 Geometry (Subdomain)
        🔺 Triangles (Concept)
          📐 Pythagorean Theorem (Concept)
          📐 Triangle Inequality (Concept)
        ⭕ Circles (Concept)
          📐 Circumference (Concept)
          📐 Area Formulas (Concept)
    ```
  </Step>

  <Step title="Add Cross-References">
    Create connections between related topics across different hierarchies to build a comprehensive knowledge network.
  </Step>
</Steps>

## Topic Management Interface

### Topic Creation Form

<AccordionGroup>
  <Accordion title="Basic Information">
    * **Name**: Clear, descriptive topic title
    * **Category**: Select from Concept, Person, Event, Domain, or Subdomain
    * **Description**: Detailed explanation of the topic's scope and significance
    * **Parent Topic**: Select hierarchical relationship (optional)
    * **Aliases**: Alternative names or terms for the topic
  </Accordion>

  <Accordion title="Relationships">
    * **Prerequisites**: Topics that should be understood first
    * **Related Topics**: Connected concepts, people, or events
    * **Subtopics**: Child topics within this area
    * **Cross-References**: Links to topics in other hierarchies
  </Accordion>

  <Accordion title="Metadata">
    * **Difficulty Level**: Complexity rating for the topic
    * **Grade Level**: Appropriate educational level
    * **Subject Areas**: Associated academic disciplines
    * **Keywords**: Search terms and tags for discoverability
  </Accordion>
</AccordionGroup>

### Visual Topic Trees

<Info>
  The Topic Trees interface provides a visual representation of your knowledge hierarchy, making it easy to understand relationships and identify gaps in your organizational structure.
</Info>

**Tree View Features:**

* **Expandable Nodes**: Click to expand or collapse topic branches
* **Drag-and-Drop**: Reorganize topics by dragging them to new positions
* **Color Coding**: Different colors for each topic category type
* **Search and Filter**: Find specific topics within large hierarchies
* **Zoom Controls**: Adjust view level for large topic trees

## Topic Category Examples

### Concepts

Abstract ideas and principles that form the foundation of understanding:

<Tabs>
  <Tab title="Scientific Concepts">
    * **Photosynthesis**: Process by which plants convert light energy
    * **Evolution**: Change in heritable traits over successive generations
    * **Gravity**: Fundamental force of attraction between masses
    * **Atomic Structure**: Organization of protons, neutrons, and electrons
  </Tab>

  <Tab title="Mathematical Concepts">
    * **Fractions**: Parts of a whole expressed numerically
    * **Probability**: Likelihood of events occurring
    * **Functions**: Mathematical relationships between variables
    * **Geometry**: Study of shapes, sizes, and spatial relationships
  </Tab>

  <Tab title="Social Concepts">
    * **Democracy**: System of government by the people
    * **Justice**: Principle of fairness and moral rightness
    * **Culture**: Shared beliefs and practices of a group
    * **Economics**: Study of resource allocation and distribution
  </Tab>
</Tabs>

### People

Individuals who have made significant contributions to knowledge and society:

<AccordionGroup>
  <Accordion title="Scientists and Inventors">
    * **Marie Curie**: Pioneer in radioactivity research
    * **Albert Einstein**: Developer of theory of relativity
    * **Charles Darwin**: Formulator of evolutionary theory
    * **Nikola Tesla**: Inventor and electrical engineer
  </Accordion>

  <Accordion title="Historical Figures">
    * **George Washington**: First President of the United States
    * **Cleopatra**: Last pharaoh of Ancient Egypt
    * **Mahatma Gandhi**: Leader of Indian independence movement
    * **Nelson Mandela**: Anti-apartheid activist and South African president
  </Accordion>

  <Accordion title="Artists and Writers">
    * **Leonardo da Vinci**: Renaissance artist and inventor
    * **William Shakespeare**: English playwright and poet
    * **Frida Kahlo**: Mexican painter and cultural icon
    * **Maya Angelou**: American poet and civil rights activist
  </Accordion>
</AccordionGroup>

### Events

Significant occurrences that have shaped history and understanding:

<CardGroup cols={2}>
  <Card title="Historical Events" icon="scroll">
    * **American Revolution**: Colonial independence from Britain
    * **Industrial Revolution**: Transformation to mechanized production
    * **World War II**: Global conflict from 1939-1945
    * **Moon Landing**: First human steps on lunar surface
  </Card>

  <Card title="Scientific Discoveries" icon="flask">
    * **Discovery of DNA Structure**: Watson and Crick's double helix
    * **Penicillin Discovery**: Fleming's antibiotic breakthrough
    * **Theory of Relativity**: Einstein's revolutionary physics
    * **Human Genome Project**: Complete mapping of human DNA
  </Card>
</CardGroup>

## Advanced Topic Features

### Topic Relationships

<Warning>
  Carefully consider topic relationships to avoid circular dependencies and ensure logical learning progressions.
</Warning>

**Relationship Types:**

* **Hierarchical**: Parent-child relationships within the same category
* **Sequential**: Topics that build upon each other in a specific order
* **Associative**: Related topics that enhance understanding when studied together
* **Comparative**: Topics that are best understood through comparison and contrast

### Content Association

Link educational content to topics for improved organization:

<Steps>
  <Step title="Automatic Association">
    AI analyzes content and suggests relevant topic assignments based on:

    * Text analysis and keyword extraction
    * Subject matter identification
    * Conceptual similarity matching
    * Historical and contextual relevance
  </Step>

  <Step title="Manual Curation">
    Educators can:

    * Review and modify AI suggestions
    * Add additional topic associations
    * Create custom topic mappings
    * Establish content-topic quality standards
  </Step>

  <Step title="Validation">
    System validates topic associations to ensure:

    * Logical consistency with topic hierarchy
    * Appropriate difficulty level alignment
    * Comprehensive coverage of topic areas
    * Quality and relevance of associations
  </Step>
</Steps>

### Topic Analytics

Monitor topic usage and effectiveness:

<AccordionGroup>
  <Accordion title="Usage Metrics">
    * **Content Coverage**: Number of content items associated with each topic
    * **Learning Activity**: Frequency of topic access by students
    * **Assessment Performance**: Student success rates on topic-related assessments
    * **Engagement Patterns**: Time spent on topic-related content
  </Accordion>

  <Accordion title="Gap Analysis">
    * **Content Gaps**: Topics with insufficient supporting materials
    * **Difficulty Imbalances**: Topics lacking appropriate level progression
    * **Relationship Gaps**: Missing connections between related topics
    * **Coverage Analysis**: Comprehensive review of topic representation
  </Accordion>
</AccordionGroup>

## Best Practices

### Hierarchy Design

<Tip>
  Start with broad categories and progressively add detail. It's easier to split topics that become too broad than to merge topics that are too narrow.
</Tip>

**Effective Hierarchy Principles:**

* **Logical Grouping**: Group related concepts under common parent topics
* **Consistent Depth**: Maintain similar levels of detail across parallel branches
* **Clear Boundaries**: Ensure topics have distinct, non-overlapping scopes
* **Scalable Structure**: Design hierarchies that can grow with additional content

### Naming Conventions

* **Descriptive Names**: Use clear, unambiguous topic names
* **Consistent Terminology**: Maintain consistent language across related topics
* **Searchable Keywords**: Include terms that users are likely to search for
* **Avoid Jargon**: Use accessible language appropriate for your audience

## Next Steps

<CardGroup cols={2}>
  <Card title="Skill Mapping" icon="target" href="/skillshop-client/assessments">
    Learn to connect topics to skill competencies and learning objectives
  </Card>

  <Card title="Content Integration" icon="link" href="/skillshop-client/content">
    Associate educational content with your topic hierarchy
  </Card>

  <Card title="Assessment Alignment" icon="clipboard-check" href="/skillshop-client/assessments">
    Create assessments that evaluate topic-specific knowledge
  </Card>

  <Card title="Learning Paths" icon="route" href="/skillshop-client/learning">
    Build learning experiences around your topic structure
  </Card>
</CardGroup>

***

*Ready to build comprehensive assessments? Continue to [Assessment Creation](/skillshop-client/assessments) to learn about evaluation and testing tools.*