Paranoia社区贡献指南：如何参与项目开发

Paranoia是一个为Rails 5、6和7重新实现的acts_as_paranoid功能，它允许你对ActiveRecord对象调用destroy时不会真正删除数据库记录，而是通过设置deleted_at字段来隐藏记录。这个开源项目欢迎社区成员的参与和贡献，本指南将详细介绍如何为Paranoia项目贡献自己的力量。

🤝 欢迎加入Paranoia社区

Paranoia是一个开源项目，我们鼓励大家积极参与贡献。无论你是想修复bug、改进文档还是添加新功能，都可以通过以下方式参与。

📝 提交问题报告

当你发现Paranoia项目中的问题时，可以通过提交issue来报告。为了帮助我们快速定位和解决问题，请提供以下详细信息：

• 重现问题的完整步骤列表
• 你期望发生什么 vs 实际发生了什么
• 你的应用程序完整的Gemfile.lock文件
• 任何相关的堆栈跟踪信息

在99%的情况下，这些信息足以确定问题的原因和解决方案。

🔧 提交Pull Request

我们很乐意接受添加文档、修复bug以及在特定情况下为Paranoia添加新功能的pull request。

快速贡献指南

1. Fork项目仓库 - 首先fork Paranoia项目

2. 运行测试 - 我们只接受通过测试的pull request，确保你有一个干净的起点

3. 创建新分支并修改代码 - 创建新分支，进行修改并为你的更改添加测试。只有重构和文档更改不需要新测试。如果你正在添加功能或修复bug，我们需要测试！

4. 提交pull request - 推送到你的fork并提交pull request

📋 项目行为准则

Paranoia项目遵循贡献者行为准则，致力于为所有参与者创造一个开放和热情的环境。我们要求所有贡献者：

• 使用欢迎和包容的语言
• 尊重不同的观点和经验
• 优雅地接受建设性批评
• 关注什么对社区最有利

🧪 测试你的贡献

在提交pull request之前，请确保运行所有测试。你可以在test/paranoia_test.rb中找到测试文件，了解项目的测试结构和要求。

📚 了解项目结构

为了更好地参与贡献，建议先了解Paranoia的项目结构：

• 核心实现代码：lib/paranoia/
• ActiveRecord适配器：lib/paranoia/active_record_5_2.rb
• RSpec支持：lib/paranoia/rspec.rb

🎯 贡献类型

目前Paranoia主要接受以下类型的贡献：

• Bug修复 - 解决已知问题
• 文档改进 - 完善使用说明和API文档
• 新版本Rails支持 - 确保项目与最新的Rails版本兼容

💡 最佳实践

• 在修改代码前，仔细阅读相关的文档和代码注释
• 遵循项目的编码风格和约定
• 确保你的修改不会破坏现有功能
• 在提交前进行充分的本地测试

加入Paranoia社区，让我们一起改进这个实用的Rails软删除解决方案！🚀