راهنمای عملی

ساختن پروفایل GitHub، قدم‌به‌قدم

الان پروفایلت نه بیو دارد نه README، و بیشتر مخزن‌های عمومی‌ات مال سال‌های ۲۰۲۱ و ۲۰۲۲ یا فورک هستند. یک استخدام‌کننده حدود ۳۰ ثانیه آنجا وقت می‌گذارد. هدف: در ۳۰ ثانیه ببیند تو کی هستی، ۶ پروژهٔ قوی و کار پیوستهٔ اخیر.

  1. اطلاعات پایهٔ پروفایل

    Settings → Public profile:

    • اسم، و همان عکس LinkedIn
    • بیو: یک خط (متنش پایین است، انگلیسی است چون پروفایل انگلیسی است)
    • موقعیت مکانی، لینک LinkedIn و وب‌سایت = لینک زندهٔ Pace
    Software engineer at Technance · TypeScript, React, Next.js, React Native · Growing into [your path]
  2. README پروفایل

    یک مخزن عمومی بساز که نامش دقیقاً مثل نام کاربری‌ات باشد: mowhcen/mowhcen. README آن بالای پروفایلت نشان داده می‌شود. کوتاه و واقعی نگهش دار، بدون دیوار نشان و کارت آمار. متن زیر انگلیسی است چون پروفایل انگلیسی است.

    ### Hi, I'm Mohammad Mohsen
    
    I build trading products for web and mobile at Technance — TypeScript, React, Next.js and React Native, in a large Turborepo monorepo. 1,500+ merged pull requests since 2024.
    
    **Now:** a 6-month plan to grow into [your path], tracked in public with [Pace](https://pace.mowhcen.dev) — a roadmap that re-plans itself when I fall behind.
    
    **Projects**
    - [Pace](https://github.com/mowhcen/pace-planner) — roadmap planner with pace-based forecasts (React, TypeScript)
    - [next project] — [one line]
    
    **Writing:** I post what I learn on [LinkedIn](https://www.linkedin.com/in/mowhcen).
  3. مخزن‌های قدیمی را مرتب کن

    فقط چیزهایی را عمومی نگه دار که به آن‌ها افتخار می‌کنی. بایگانی کن یا خصوصی کن، تاریخچه‌ات را پاک نکن.

    • تمرین‌های اولیه (hangman، note-app، task-app، Recipe-App، Indecision، snake-and-ladder، database-hw، web-engineering): خصوصی یا بایگانی کن.
    • فورک‌هایی که کار تو در آن‌ها نیست (rsuite، react-dates، react-pageflip، country-flags، react-datepicker2، react-multi-date-picker): فورک را حذف کن. فورکی که هرگز تغییرش نداده‌ای چیزی اضافه نمی‌کند.
    • cookies-next: فقط اگر یک PR ادغام‌شده فرستاده‌ای نگهش دار و آن PR را در README لینک کن.
    • نام‌ها و توضیح‌ها را درست کن: «web3expamle» ← «web3-example». از سه پروژهٔ شروع Next.js یکی را نگه دار.
    • پروژه‌های خصوصی که می‌توانند بدرخشند (مثلاً mizban-chi): فقط وقتی عمومی کن که کد خودت باشد، رمز و کلید نداشته باشد و کار مشتری نباشد.
  4. یک README واقعی برای هر مخزن پین‌شده

    اسکرین‌شات یا GIF از همه مهم‌تر است. این‌ها را هم تنظیم کن: توضیح، لینک وب‌سایت، ۳ تا ۵ موضوع (topic) و مجوز MIT. قالب زیر انگلیسی است چون پروژه‌هایت انگلیسی‌اند.

    # [Project name]
    
    [One sentence: what it does and who it is for.]
    
    ![Screenshot](docs/screenshot.png)
    
    **Live:** [link] · **Stack:** [tech]
    
    ## Why
    [The problem in 2–3 sentences.]
    
    ## Features
    - [feature]
    - [feature]
    
    ## How it works
    [The one interesting technical idea. A small diagram helps.]
    
    ## Run it
    pnpm install
    pnpm dev
    
    ## What I learned
    - [lesson]
  5. ۶ مخزن را پین کن

    پروفایل ← «Customize your pins». جدیدترین و قوی‌ترین اول.

    • حالا: pace-planner، ۲ پروژهٔ قدیمیِ بهترت، و اگر مشارکت کرده‌ای cookies-next.
    • بعداً: دفتر یادگیری‌ات، پروژهٔ مسیرت (tiny-limiter، Ship Radar یا نسخهٔ ۲ Pace) و پروژهٔ پایانی‌ات را جایگزین کن.
  6. مربع‌های سبزِ صادقانه

    کارت در Technance در یک مخزن خصوصی انجام می‌شود، پس به‌طور پیش‌فرض دیده نمی‌شود.

    • Settings → Public profile ← گزینهٔ «Include private contributions on my profile» را روشن کن. به‌شکل مربع‌های ناشناس نشان داده می‌شوند.
    • در روزهای یادگیری در دفتر یادگیری‌ات کامیت کن. فقط یادداشت واقعی. اسکریپت‌های کامیت ساختگی راحت لو می‌روند و به اعتمادت آسیب می‌زنند.
  7. نشان CI، نسخه‌های منتشرشده، پیش‌نمایش اجتماعی

    • یک workflow در GitHub Actions که تست‌ها را اجرا کند (Pace از قبل دارد).
    • وقتی پروژه قابل استفاده شد، نسخهٔ v1.0.0 را با یادداشت انتشار تگ کن.
    • Settings مخزن ← Social preview: یک تصویر ۱۲۸۰ در ۶۴۰ پیکسل آپلود کن تا لینک‌ها در LinkedIn خوب دیده شوند.
  8. متن‌باز، ماهی یک بار

    کوچک شروع کن: مستندات را درست کن، یک تست اضافه کن، یا یک «good first issue» را در ابزاری که از قبل استفاده می‌کنی بردار. ماهی یک PR ادغام‌شده برای ۶ ماه سیگنال قوی‌ای است.