fix: Standardize formatting in README.md for better readability

This commit is contained in:
2025-12-17 16:15:08 +08:00
parent 99c4117193
commit 3f04933b3b

View File

@@ -8,47 +8,54 @@ Your intelligent coding companion for comprehensive repository management, right
## Features
### 🏠 **Dedicated Activity Bar**
* **Custom WizGIT sidebar** with organized views for repositories, issues, and pull requests
* **Quick access** to all WizGIT functionality from the activity bar
* **Custom WizGIT sidebar** with organized views for repositories, issues, and pull requests
* **Quick access** to all WizGIT functionality from the activity bar
### 📁 **Repository Management**
* **Create repositories:** Easily create new repositories on WizGit directly from VS Code
* **Clone repositories:** Clone existing repositories with integrated UI
* **Repository discovery:** Automatic workspace detection and repository listing
* **Refresh functionality:** Keep your repository list up-to-date
* **Create repositories:** Easily create new repositories on WizGit directly from VS Code
* **Clone repositories:** Clone existing repositories with integrated UI
* **Repository discovery:** Automatic workspace detection and repository listing
* **Refresh functionality:** Keep your repository list up-to-date
### 🐛 **Issue Management**
* **Create issues:** Create new issues with intelligent workspace auto-detection
* **Repository auto-detection:** Automatically populate organization and repository from your workspace
* **Branch selection:** Choose target branch from a list of available branches (local and remote)
* **Context integration:** Create issues from file explorer or editor context menu
* **Create issues:** Create new issues with intelligent workspace auto-detection
* **Repository auto-detection:** Automatically populate organization and repository from your workspace
* **Branch selection:** Choose target branch from a list of available branches (local and remote)
* **Context integration:** Create issues from file explorer or editor context menu
### 🔀 **Pull Request Management**
* **Create pull requests:** Create PRs with comprehensive file change detection
* **File changes display:** View detailed file modifications and diffs
* **Smart branch selection:** Choose source and destination branches with intelligent defaults
* **Workspace integration:** Auto-detect repository information from your current workspace
* **Create pull requests:** Create PRs with comprehensive file change detection
* **File changes display:** View detailed file modifications and diffs
* **Smart branch selection:** Choose source and destination branches with intelligent defaults
* **Workspace integration:** Auto-detect repository information from your current workspace
### 🔐 **Authentication & Security**
* **Secure token storage:** Safely store and manage your WizGit Personal Access Token
* **Configuration management:** Easy setup and configuration clearing options
* **API endpoint flexibility:** Support for custom WizGit/Gitea instances
* **Secure token storage:** Safely store and manage your WizGit Personal Access Token
* **Configuration management:** Easy setup and configuration clearing options
* **API endpoint flexibility:** Support for custom WizGit/Gitea instances
### ⚙️ **Smart Features**
* **Workspace detection:** Automatically identify Git repositories and extract owner/repo information
* **Branch enumeration:** List and select from available local and remote branches
* **Progress tracking:** Visual progress indication during operations
* **Error handling:** Comprehensive error reporting and troubleshooting
* **Workspace detection:** Automatically identify Git repositories and extract owner/repo information
* **Branch enumeration:** List and select from available local and remote branches
* **Progress tracking:** Visual progress indication during operations
* **Error handling:** Comprehensive error reporting and troubleshooting
## Requirements
* Visual Studio Code v1.74.0 or newer.
* A valid WizGit account with API access.
* Personal Access Token from your WizGit instance.
* Visual Studio Code v1.74.0 or newer.
* A valid WizGit account with API access.
* Personal Access Token from your WizGit instance.
## Getting Started
### Initial Setup
1. **Configure WizGIT:** Open Command Palette (`Ctrl+Shift+P`) and run `WizGIT: Configure WizGIT`
2. **Enter your details:**
- WizGit API endpoint (e.g., `https://your-wizgit-instance.com/api/v1`)
@@ -56,23 +63,27 @@ Your intelligent coding companion for comprehensive repository management, right
3. **Access the sidebar:** Click the WizGIT icon in the activity bar to open the dedicated sidebar
### Creating Repositories
1. In the WizGIT sidebar, go to the **Repositories** view
2. Click the "Create Repository" button () in the title bar
3. Fill in repository details and click "Create Repository"
### Managing Issues
1. In the **Issues** view, click "Create Issue" (🐛)
2. The extension will automatically detect your workspace repository
3. Choose the target branch from the dropdown list
4. Fill in issue title and description, then submit
### Creating Pull Requests
1. In the **Pull Requests** view, click "Create Pull Request" (🔀)
2. Select source and destination branches
3. Review the automatically detected file changes
4. Add title and description, then create the PR
### Alternative Access Methods
- **Command Palette:** All commands are available via `Ctrl+Shift+P`
- **Context Menus:** Right-click in file explorer or editor to create issues
- **Keyboard Shortcuts:** Assign custom shortcuts to frequently used commands
@@ -80,37 +91,40 @@ Your intelligent coding companion for comprehensive repository management, right
## Commands
### Repository Commands
* `WizGIT: Configure WizGIT` - Set up API endpoint and authentication
* `WizGIT: Create Repository` - Create a new repository
* `WizGIT: Clone Repository` - Clone an existing repository
* `WizGIT: Clear Configuration` - Remove stored authentication data
* `WizGIT: Configure WizGIT` - Set up API endpoint and authentication
* `WizGIT: Create Repository` - Create a new repository
* `WizGIT: Clone Repository` - Clone an existing repository
* `WizGIT: Clear Configuration` - Remove stored authentication data
### Issue & PR Commands
* `WizGIT: Create Issue` - Create a new issue with workspace auto-detection
* `WizGIT: Create Pull Request` - Create a pull request with file change detection
* `WizGIT: Create Issue` - Create a new issue with workspace auto-detection
* `WizGIT: Create Pull Request` - Create a pull request with file change detection
## Extension Settings
This extension contributes the following settings:
* `wizgit.apiEndpoint` - Your WizGIT API endpoint URL
* `wizgit.autoDetect` - Automatically detect WizGIT repositories in workspace (default: `true`)
* `wizgit.statusBar.enabled` - Show WizGIT information in status bar (default: `true`)
* `wizgit.notifications.enabled` - Enable WizGIT notifications (default: `true`)
* `wizgit.defaultBranch` - Default branch name for new repositories (default: `master`)
* `wizgit.apiEndpoint` - Your WizGIT API endpoint URL
* `wizgit.autoDetect` - Automatically detect WizGIT repositories in workspace (default: `true`)
* `wizgit.statusBar.enabled` - Show WizGIT information in status bar (default: `true`)
* `wizgit.notifications.enabled` - Enable WizGIT notifications (default: `true`)
* `wizgit.defaultBranch` - Default branch name for new repositories (default: `master`)
You can access these settings through VS Code's Settings UI or by adding them to your `settings.json`.
## Known Issues
* Network connectivity issues may cause API operations to fail
* File change detection for pull requests may not work with all repository configurations
* Workspace auto-detection requires a valid Git repository with remote origin configured
* Please report any bugs or feature requests on our [Issues page](http://126.209.24.132/terence.carrera/wizgit-vscode-extension/issues)
* Network connectivity issues may cause API operations to fail
* File change detection for pull requests may not work with all repository configurations
* Workspace auto-detection requires a valid Git repository with remote origin configured
* Please report any bugs or feature requests on our [Issues page](http://126.209.24.132/terence.carrera/wizgit-vscode-extension/issues)
## Release Notes
### 0.0.4 (Current)
* Bump version to 0.0.4
* Fix issue with branch selection dropdown not populating correctly in some cases
* Improve error messages for API failures during issue and pull request creation
@@ -118,11 +132,13 @@ You can access these settings through VS Code's Settings UI or by adding them to
* Enhance UI responsiveness during long-running operations with better progress indicators
### 0.0.3
* Bump version to 0.0.3
### 0.0.2
Major feature expansion and UI improvements:
* **New dedicated activity bar** with custom WizGIT sidebar
* **Issue management** with workspace auto-detection and branch selection
* **Pull request creation** with file change detection and diff display
@@ -137,6 +153,7 @@ Major feature expansion and UI improvements:
### 0.0.1
Initial release of WizGIT:
* Core repository creation via WizGit API
* Basic authentication and configuration
* Progress tracking and error handling