╔══════════════════════════════════════════════════════════════╗
║                                                              ║
║         📚  C O M P A R A T I V E  R E L I G I O N           ║
║                    B O O K S                                 ║
║                                                              ║
╚══════════════════════════════════════════════════════════════╝

A curated open library exploring religion through an Islamic lens

---

✦ About

"Read. In the name of your Lord who created." — Quran 96:1

ComparativeReligionBooks is a community-driven digital library housing scholarly works on comparative religion, with a focus on books that illuminate, defend, and elevate the Islamic perspective. Whether you're a student, researcher, or curious mind — this collection is built for you.

All books live in the /library folder. Anyone can contribute.

---

📂 Repository Structure

ComparativeReligionBooks/
│
├── 📁 library/          ← All PDF books live here
│   ├── book-title.pdf
│   ├── book-title.pdf
│   └── ...
│
└── 📄 README.md

---

📜 The Collection

The /library folder contains peer-reviewed and community-contributed PDFs covering:

• ☪️ Islamic theology & philosophy
• 🔍 Comparative religion & interfaith analysis
• 🌍 Historical perspectives on world religions
• 📖 Scholarly defenses and apologetics of Islam
• 🕊️ Ethics, spirituality, and metaphysics

---

🤝 How to Contribute — Pull Request Guide

We warmly welcome contributions from the community! Follow the steps below to submit books via a Pull Request (PR).

⚡ Step-by-Step: Creating a Pull Request

① Fork the Repository

Click the Fork button at the top-right of this page to create your own copy of the repository.

https://github.com/SENODROOM/ComparativeReligionBooks
                                              ↑ Click Fork

② Clone Your Fork

git clone https://github.com/YOUR-USERNAME/ComparativeReligionBooks.git
cd ComparativeReligionBooks

③ Create a New Branch

Name your branch something descriptive:

git checkout -b add/5-books-on-islamic-theology

④ Add Your PDFs to the /library Folder

Place exactly 5 PDF files inside the library/ directory.

cp /path/to/your/books/*.pdf library/

Use clean, descriptive filenames:

✅  Good:   the-concept-of-god-in-islam-ahmed-deedat.pdf
❌  Avoid:  book1.pdf / FINAL_v3_copy.pdf

⑤ Stage and Commit Your Changes

git add library/
git commit -m "feat: add 5 books on comparative religion defending Islam"

⑥ Push to Your Fork

git push origin add/5-books-on-islamic-theology

⑦ Open the Pull Request

1. Go to the original repository on GitHub
2. Click "Compare & pull request"
3. Fill in the PR template (see below)
4. Submit!

---

📋 PR Template

When opening your PR, please include the following in your description:

## 📚 Book Submission

### Books Added (5 required)

| #   | Title | Author | Topic |
| --- | ----- | ------ | ----- |
| 1   | ...   | ...    | ...   |
| 2   | ...   | ...    | ...   |
| 3   | ...   | ...    | ...   |
| 4   | ...   | ...    | ...   |
| 5   | ...   | ...    | ...   |

### Why these books?

<!-- Briefly explain how each book defends or supports Islam -->

### Checklist

- [ ] All 5 PDFs are placed in the `/library` folder
- [ ] All books are relevant to comparative religion
- [ ] All books defend or support the Islamic perspective
- [ ] File names are clean and descriptive
- [ ] No duplicate titles already in the library

---

📏 PR Rules & Guidelines

Please read carefully before submitting. PRs that don't meet these requirements will be closed.

Rule	Requirement
📖 Book Count	Each PR must contain exactly 5 PDF books
☪️ Content	All books must defend or support Islam — through theology, comparative analysis, apologetics, or history
📁 Location	All PDFs must be placed inside the library/ folder
🏷️ Naming	Use descriptive filenames: title-author.pdf (lowercase, hyphens, no spaces)
🚫 No Duplicates	Check existing files before submitting to avoid duplicates
📄 Format	PDF format only — no .epub, .docx, or other formats
✍️ PR Description	Must include book titles, authors, and a brief justification

Note: Books promoting anti-Islamic content, hate speech, or misinformation will be rejected without review.

---

🔍 Review Process

You submit PR
      ↓
Maintainer reviews book relevance & PR rules
      ↓
Feedback given (if needed) → You update PR
      ↓
PR approved & merged ✅

Reviews typically happen within 3–7 days. Be patient and respectful in discussions.

---

🌟 Contributors

A heartfelt جزاكم الله خيرًا (Jazakumullahu Khayran) — may Allah reward all those who have contributed to spreading knowledge.

---

"Seeking knowledge is an obligation upon every Muslim." — Prophet Muhammad ﷺ (Ibn Majah)

---

⭐ Star this repo if you find it valuable 🔁 Share it to spread beneficial knowledge