Repository navigation

Contributing to PDF Manager

Thank you for your interest in contributing to PDF Manager! This document provides guidelines for contributing.

Code of Conduct

Please be respectful and constructive in all interactions.

How to Contribute

Reporting Bugs

Check if the bug has already been reported in Issues
Create a new issue with:
- Clear title and description
- Steps to reproduce
- Expected vs actual behavior
- Device info and Android version

Suggesting Features

Check existing issues for similar suggestions
Create a new issue with the enhancement label
Describe the feature and its use case

Pull Requests

Fork the repository
Create a feature branch from main
Make your changes
Ensure code follows project style
Test your changes thoroughly
Submit a PR with a clear description

Development Setup

Clone the repo and dependencies (see README)
Open in Android Studio
Sync Gradle
Run on device/emulator

Code Style

Follow Kotlin Coding Conventions
Use meaningful names
Keep functions focused and small
Add comments for complex logic

Commit Messages

Use clear, descriptive commit messages:

feat: Add virtual folder support
fix: Resolve PDF loading crash on large files
docs: Update README with build instructions

Questions?

Open an issue with the question label.