# Contributing to Iizuka LinkedIn Network

**Iizuka LinkedIn Network** · Chikuho Region · Fukuoka Prefecture · Japan

Thank you for helping build the **Chikuho Region's** most comprehensive professional ecosystem platform. This guide explains how to contribute — no technical experience required.

---

## Why Your Contribution Matters

Every resource added, every city page updated, and every success story shared makes this platform more valuable for the **370,000+ professionals and residents** of the Chikuho Region. You are directly contributing to regional revitalization.

---

## What You Can Contribute

### 📝 Content
| Type | Where | Who |
|------|-------|-----|
| City information | `cities/[city].md` | Locals, business owners |
| Company listings | `companies/[sector]/README.md` | Anyone |
| Job postings | `jobs/[category]/README.md` | Employers, recruiters |
| Event listings | `events/[year]/README.md` | Organizers |
| Success stories | `success-stories/[type].md` | Professionals, founders |
| AI resources | `resources/ai/README.md` | Practitioners |
| DX case studies | `resources/dx/README.md` | Consultants, businesses |
| Startup resources | `startups/README.md` | Founders, advisors |
| Community listings | `communities/[type]/README.md` | Community leaders |
| Research | `research/README.md` | Academics, analysts |

### 🛠️ Technical
| Type | Where |
|------|-------|
| Broken link fixes | Any `.md` file |
| Typo corrections | Any `.md` file |
| Formatting improvements | Any `.md` file |
| New scripts | `scripts/` |
| Translation (JP ↔ EN) | Any file |

---

## How to Contribute (Step by Step)

### Option A: Via GitHub (Recommended)

**Step 1: Fork the repository**
```
https://github.com/ShinnosukeMoriFukuokaJP/Iizuka-LinkedIn-Network-Repository-Structure
```
Click **Fork** → **Create fork**

**Step 2: Clone your fork**
```bash
git clone https://github.com/YOUR-USERNAME/Iizuka-LinkedIn-Network-Repository-Structure.git
cd Iizuka-LinkedIn-Network-Repository-Structure
```

**Step 3: Create a branch**
```bash
git checkout -b add/iizuka-company-listing
# or: fix/broken-link-cities
# or: update/tagawa-city-info
```

**Step 4: Make your changes**
Edit or create `.md` files. Follow the style guide below.

**Step 5: Commit and push**
```bash
git add .
git commit -m "feat: add [Company Name] to companies/ai/"
git push origin add/iizuka-company-listing
```

**Step 6: Open a Pull Request**
Go to the original repository → **Pull Requests** → **New Pull Request**
Fill in the PR template and submit.

### Option B: Edit Directly on GitHub

For small fixes:
1. Open the file on GitHub
2. Click the ✏️ pencil icon
3. Make changes
4. Click **Propose changes**
5. Submit the Pull Request

### Option C: Submit via Issue

Not comfortable with Git? Open a GitHub Issue with:
- Label: `resource`, `city-content`, `event`, or `bug`
- Your content or suggestion
- A maintainer will add it for you

### Option D: Email

Send contributions to [community@iizuka-linkedin-network.org](mailto:community@iizuka-linkedin-network.org)

---

## Style Guide

### Language
- English and Japanese are equally welcome
- Bilingual content (EN + JP) is ideal for city and resource pages
- Be professional, clear, and concise

### Markdown Formatting
- Use `##` for main sections, `###` for subsections
- Use tables for structured data (companies, tools, events)
- Add breadcrumb navigation at top: `[← Parent](../README.md)`
- Add footer: `*Iizuka LinkedIn Network · [Section] · Chikuho Region · Fukuoka Prefecture · Japan*`

### Links
- Always use relative links for internal navigation: `[Cities](../cities/README.md)`
- Verify all links work before submitting
- External links should open to trusted sources only

### Content Standards
- No spam, self-promotion without community value, or advertising
- Factual claims should include sources
- Company and job listings must be real and current
- Event listings must include date, format, and contact information

---

## Commit Message Format

```
feat: add [description]       # New content or feature
fix: correct [description]    # Bug fix or correction
update: improve [description] # Enhancement to existing content
docs: clarify [description]   # Documentation improvement
translate: [file] JP→EN       # Translation work
```

---

## Pull Request Review Process

1. A maintainer reviews your PR within **7 days**
2. They may request minor changes
3. Once approved, it's merged to `main`
4. Your contribution is live immediately

---

## Contributor Recognition

All contributors receive:
- ✅ Listed in repository contributors
- ✅ Monthly newsletter spotlight (notable contributions)
- ✅ LinkedIn Group recognition post
- ✅ Credit in the Annual Chikuho Innovation Report

---

## First Time?

Look for issues labeled `good first issue` or `help wanted`. These are specifically curated for new contributors.

**Easy first contributions:**
- Add your company or employer to the companies directory
- Add an upcoming event you know about
- Fix a typo you noticed
- Translate a section to Japanese or English

---

## Code of Conduct

All contributors must follow our [Code of Conduct](CODE_OF_CONDUCT.md). We maintain a welcoming, professional environment for everyone.

---

## Questions?

- 💬 Open a GitHub Issue with label `question`
- 💼 Post in the [LinkedIn Group](https://www.linkedin.com/groups/14722875)
- 📧 Email [community@iizuka-linkedin-network.org](mailto:community@iizuka-linkedin-network.org)

---

*Thank you for building the Chikuho Region's future.*
*Iizuka LinkedIn Network · Chikuho Region · Fukuoka Prefecture · Japan*