Skip to content

[DOCS] : Create User Documentation Page in Frontend #22

@RishiGoswami-code

Description

@RishiGoswami-code

Description

The project currently lacks a dedicated documentation/help page that explains how users can use the platform effectively. New users should be able to understand the workflow, key features, and common actions without needing external guidance.

This issue focuses on creating a user-friendly documentation page directly within the frontend application.

Objective

Build a dedicated Documentation / User Guide page that helps users:

  • Understand the purpose of the platform
  • Learn how to use major features
  • Follow step-by-step workflows
  • Troubleshoot common issues
  • Access FAQs and support resources

What Needs to Be Implemented

1. Create Documentation Page

Add a new route/page such as:

/docs
/help
/documentation

The page should be easily accessible from the navigation menu.


2. Add Core Documentation Sections

Include the following sections:

Getting Started
  • What the platform does
  • Who it is for
  • Quick setup guide
Uploading Documents
  • Supported file formats
  • Upload process
  • Best practices
AI Assessment Workflow
  • Creating assessments
  • Uploading answer sheets
  • Running evaluation
  • Reviewing results
Dashboard Overview
  • Understanding analytics
  • Viewing reports
  • Exporting results
User Roles & Permissions
  • Student
  • Teacher
  • Principal
  • Administrator
Frequently Asked Questions (FAQ)

Examples:

  • Why is my document not processing?
  • Which file formats are supported?
  • How long does grading take?
  • How can I download reports?

3. Improve User Experience

Consider adding:

  • Search functionality
  • Sidebar navigation
  • Table of contents
  • Collapsible sections
  • Mobile responsiveness
  • Dark mode support

4. Documentation Content Structure

The content should be:

  • Beginner-friendly
  • Well-organized
  • Easy to scan
  • Written in simple language
  • Consistent with the project's UI design

Acceptance Criteria

  • Documentation page created
  • Accessible from frontend navigation
  • Core user guides added
  • FAQ section implemented
  • Responsive design supported
  • Documentation follows project styling
  • No console errors or broken links

Suggested Enhancements (Optional)

  • Interactive walkthroughs
  • Video tutorials
  • Screenshots/GIF demonstrations
  • Searchable documentation
  • Context-sensitive help links

Impact

A dedicated documentation page will improve user onboarding, reduce support requests, and help users quickly understand how to use the platform's features without external assistance.

Difficulty: Beginner

Labels: documentation, frontend, good first issue, up-for-grabs, help wanted

Metadata

Metadata

Assignees

No one assigned
    No fields configured for Feature.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions