Skip to content

Latest commit

 

History

History
102 lines (77 loc) · 1.72 KB

CONTRIBUTING.md

File metadata and controls

102 lines (77 loc) · 1.72 KB

Contributing to TelDrive

This guide will help you get started with contributing to TelDrive.

Development Setup

Prerequisites

  • Go (1.19 or later)
  • Node.js (for semver dependency)
  • Git
  • Make
  • PowerShell (for Windows) or Bash (for Unix-like systems)

Initial Setup

  1. Clone the repository:
git clone https://github.com/tgdrive/teldrive.git
cd teldrive
  1. Install dependencies:
make deps

Building TelDrive

Complete Build

To build both frontend and backend:

make build

Frontend Development

The frontend is managed in a separate repository (teldrive-ui). The main repository pulls the latest frontend release during build.

To set up the frontend:

make frontend

Backend Development

To build the backend only:

make backend

Running TelDrive

After building, run the application:

make run

Feature Development

  1. Create a new branch for your feature:
git checkout -b feature/your-feature-name
  1. Generate API Spec:
make gen

Version Management

We follow semantic versioning (MAJOR.MINOR.PATCH):

  • For bug fixes:
make patch-version
  • For new features:
make minor-version
  • For breaking changes:
make major-version

Pull Request Guidelines

  1. Branch Naming:

    • feature/ for new features
    • fix/ for bug fixes
    • docs/ for documentation changes
    • refactor/ for code refactoring

  2. Commit Messages:

    • Use clear, descriptive commit messages
    • Reference issues when applicable

  3. Pull Request Description:

    • Describe the changes made
    • Include any relevant issue numbers
    • List any breaking changes