Skip to content

Conversation

@sumitjain236
Copy link
Member

@sumitjain236 sumitjain236 commented Mar 29, 2025

Documentation Should Have dashboard to manage the docs page, It can have analytics , configurations, settings

1. Dashboard - first page of dashboard it will have analytics and info of docs

image image

2. Editor - editor is important asset of dashboard it have list of pages we have in our docs, it the section where user can manage pages, create, delete edit

image image image

3. Sidebar - It is the section where user can manage how to showcase actual docs sidebar , Parent Section sequence everything can handle here

image

4. Navbar and Footer - User can manage the Navbar Button (Buttons, Menu Buttons), Can Manage Footer Items

image image

5. Settings

image

Actual Docs Site look like this

image

…on pages and integrate it into the DocsEditor
@sumitjain236 sumitjain236 marked this pull request as draft March 29, 2025 20:25
@sumitjain236 sumitjain236 self-assigned this Mar 29, 2025
@sumitjain236 sumitjain236 requested review from Copilot and removed request for Copilot March 29, 2025 20:33
Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR adds a dashboard for managing documentation pages, including a drag‐and‐drop sidebar, document upload with image conversion, and updated routing and API endpoints for enhanced documentation management.

  • Adds multiple drag‐and‐drop components and utilities for the sidebar and task management.
  • Integrates image upload enhancements with WebP conversion in the file upload workflow.
  • Updates backend API endpoints and routing to support new dashboard functionality.

Reviewed Changes

Copilot reviewed 48 out of 51 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
dashboard/src/components/features/Sidebar/utils.ts Adds utility functions for handling draggable data in the sidebar.
dashboard/src/components/features/Sidebar/multipleContainerKeyboardPreset.ts Implements customizable keyboard navigation for draggable containers.
dashboard/src/components/features/Sidebar/TaskCard.tsx Introduces a task card component with delete and drag–handle support.
dashboard/src/components/features/Sidebar/KanbanBoard.tsx Provides a Kanban-style board for managing sidebar items and tasks.
dashboard/src/components/features/Sidebar/DashboardSidebar.tsx Implements the dashboard sidebar, fetching data via API hooks.
dashboard/src/components/features/Sidebar/BoardColumn.tsx Establishes board columns with add, delete, and reorder functionalities.
dashboard/src/components/common/ImageUploader2/FileDrop.tsx Updates file drop component styling for improved user experience.
dashboard/src/components/common/ImageUploader2/DocumentUploadModal.tsx Enhances modal with better layout and privacy settings for document uploads.
dashboard/src/components/common/Checkbox/CreatableSelect.tsx Minor fix: Adjusts conditional class application for checkbox select.
dashboard/src/components/common/AsyncDropdown/AsyncDropdown.tsx Expands the async dropdown functionality with improved state management.
dashboard/src/App.tsx Modifies routing to integrate the new documentation dashboard routes.
commit/www/commit.py Exposes additional commit docs data via bootstrapping for the docs dashboard.
commit/hooks.py Updates website route rules to align with new documentation endpoints.
commit/commit/doctype/commit_docs_page/commit_docs_page.py Adds logic to capture and enqueue preview screenshots before saving pages.
commit/commit/doctype/commit_docs/commit_docs.py Updates sidebar treatment and introduces a new function to manage sidebar items.
commit/api/preview.py Implements asynchronous screenshot capture and preview image saving.
commit/api/convert_to_webp.py Provides conversion of images to WebP format for optimized image delivery.
Files not reviewed (3)
  • commit/commit/doctype/commit_docs/commit_docs.json: Language not supported
  • commit/commit/doctype/commit_docs_page/commit_docs_page.json: Language not supported
  • dashboard/package.json: Language not supported
Comments suppressed due to low confidence (1)

dashboard/src/components/features/Sidebar/BoardColumn.tsx:71

  • [nitpick] The filters parameter is passed as a string (title) rather than an object; consider using an object (e.g. { title: title }) to ensure proper filtering.
call.get('frappe.client.get_value', { doctype: 'Commit Docs Page', filters: title, fieldname: ['route', 'title'] })

@sumitjain236 sumitjain236 requested a review from Copilot March 29, 2025 20:36

This comment was marked as duplicate.

@nikkothari22
Copy link
Member

How soon can we publish our docs for Raven and other libraries here?

We need the following blocks:

  1. YouTube embeds
  2. Code blocks (single language)
  3. API block

@sumitjain236
Copy link
Member Author

How soon can we publish our docs for Raven and other libraries here?

We need the following blocks:

  1. YouTube embeds
  2. Code blocks (single language)
  3. API block

For Now We have Youtube embeds and Code Blocks, will add API block soon

… Sidebar components for improved visibility control
@sumitjain236
Copy link
Member Author

Attaching Recording of complete flow

Screen.Recording.2025-03-31.at.1.49.29.PM.mov

@sumitjain236 sumitjain236 marked this pull request as ready for review March 31, 2025 08:34
@sumitjain236 sumitjain236 merged commit 1570daa into main Apr 2, 2025
@sumitjain236 sumitjain236 deleted the 85-create-a-dashboard-for-managing-docs branch April 2, 2025 12:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Create a dashboard for Managing Docs

3 participants