Skip to content

FEATURE REQUEST: Focused Onboarding Workflow for New Contributors #116

@smokeyScraper

Description

@smokeyScraper

Is your feature request related to a problem?

  • Yes, it is related to a problem

Describe the feature you'd like

🌟 Feature Description

This feature introduces a structured, conversational Onboarding Workflow managed by a dedicated OnboardingNode. The workflow's primary responsibilities are to:

  1. Welcome new users who join the Discord server for the first time.
  2. Check if the user's GitHub account is verified and prompt them to do so using a /verify command if it isn't.
  3. Conclude the onboarding process by clearly advertising the core capabilities of the main DevRel Agent, setting clear expectations for how users can interact with it.

🔍 Problem Statement

Currently, there is no standardized, automated process to welcome and orient new contributors when they join the community. This can lead to:

  • New members feeling lost or unsure of how to get started.
  • A lack of clarity on how to use the Devr.AI assistant and what its capabilities are.
  • A missed opportunity to perform critical initial setup, like GitHub account verification, which is essential for personalized assistance.

🎯 Expected Outcome

The successful implementation of this feature will result in:

  • A Welcoming Experience: Every new member is greeted automatically and guided through the first essential step.
  • Increased Verification: A clear and early prompt will encourage more users to link their GitHub accounts.
  • Clear Expectations: Users will be explicitly told what they can ask the bot, leading to more effective and successful interactions.
  • Improved User Autonomy: By pointing users to commands like /verify and /help, the system empowers them to take action independently.
  • Streamlined Architecture: The OnboardingNode will have a single, focused responsibility, handing off all subsequent, more complex queries to the main DevRel Agent.

📷 Screenshots and Design Ideas

The design is purely conversational. The flow should be implemented as follows:

1. Initial Trigger (New User Joins)

  • Bot: "👋 Welcome to the Devr.AI community! I'm here to help you get started on your contributor journey. To give you the best recommendations for repositories and issues, I first need to link your GitHub account. This is a one-time step that helps us align tasks with your profile. To get started, please use the /verify command. If you'd like to see everything I can help with, you can use /help at any time. Would you like to verify your GitHub account now or skip this step for now? You can always do it later."

2. Final Hand-off Message (After verification or skip)

  • Bot: "You're all set! As the Devr.AI assistant, my main purpose is to help you navigate and contribute to our projects. Here’s a look at what you can ask me to do. You can ask me to:

    • Explore Our Projects:
      • "Show me our most active repositories."
    • Find Ways to Contribute:
      • "Are there any 'good first issues' available?"
    • Answer Project Questions:
      • "How do I set up the local development environment?"

    Feel free to ask me anything related to the project. What's on your mind?"


📋 Additional Context

This workflow is a foundational component of the DevRel Agent's user experience. It serves as the primary entry point for new community members and is critical for establishing a positive and productive first interaction. Its completion allows other specialized nodes (GitHubToolkitNode, FAQHandlerNode) to assume that a user has already been formally welcomed.

Record

  • I agree to follow this project's Code of Conduct
  • I want to work on implementing this feature

Metadata

Metadata

Assignees

Labels

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions