10 KiB

Raw Blame History

Kuchangia Data Science kwa Kompyuta

Asante kwa nia yako ya kuchangia mtaala wa Data Science kwa Kompyuta! Tunakaribisha michango kutoka kwa jamii.

Jedwali la Maudhui

Kanuni za Maadili

Mradi huu umechukua Kanuni za Maadili za Microsoft Open Source. Kwa maelezo zaidi angalia Maswali Yanayoulizwa Mara kwa Mara kuhusu Kanuni za Maadili au wasiliana na opencode@microsoft.com kwa maswali au maoni ya ziada.

Ninawezaje Kuchangia?

Kuripoti Hitilafu

Kabla ya kuunda ripoti za hitilafu, tafadhali angalia masuala yaliyopo ili kuepuka nakala. Unapounda ripoti ya hitilafu, jumuisha maelezo mengi iwezekanavyo:

Tumia kichwa kilicho wazi na cha kuelezea
Eleza hatua halisi za kuzalisha tatizo
Toa mifano maalum (vipande vya msimbo, picha za skrini)
Eleza tabia uliyotazama na kile ulichotarajia
Jumuisha maelezo ya mazingira yako (OS, toleo la Python, kivinjari)

Kupendekeza Uboreshaji

Mapendekezo ya uboreshaji yanakaribishwa! Unapopendekeza uboreshaji:

Tumia kichwa kilicho wazi na cha kuelezea
Toa maelezo ya kina ya uboreshaji uliopendekeza
Eleza kwa nini uboreshaji huu ungekuwa muhimu
Orodhesha vipengele vyovyote vinavyofanana katika miradi mingine, ikiwa inafaa

Kuchangia kwa Nyaraka

Uboreshaji wa nyaraka unathaminiwa kila wakati:

Sahihisha makosa ya tahajia na sarufi
Boresha uwazi wa maelezo
Ongeza nyaraka zinazokosekana
Sasisha maelezo yaliyopitwa na wakati
Ongeza mifano au matumizi

Kuchangia Msimbo

Tunakaribisha michango ya msimbo ikijumuisha:

Masomo mapya au mazoezi
Marekebisho ya hitilafu
Uboreshaji wa daftari zilizopo
Seti mpya za data au mifano
Uboreshaji wa programu ya maswali

Kuanza

Mahitaji ya Awali

Kabla ya kuchangia, hakikisha una:

Akaunti ya GitHub
Git imewekwa kwenye mfumo wako
Python 3.7+ na Jupyter imewekwa
Node.js na npm (kwa michango ya programu ya maswali)
Uelewa wa muundo wa mtaala

Angalia INSTALLATION.md kwa maelezo ya kina ya usanidi.

Fork na Clone

Fork hifadhi kwenye GitHub

Clone fork yako kwa ndani:

git clone https://github.com/YOUR-USERNAME/Data-Science-For-Beginners.git
cd Data-Science-For-Beginners

Ongeza remote ya upstream:

git remote add upstream https://github.com/microsoft/Data-Science-For-Beginners.git

Unda Tawi

Unda tawi jipya kwa kazi yako:

git checkout -b feature/your-feature-name
# or
git checkout -b fix/your-bug-fix

Miongozo ya majina ya matawi:

feature/ - Vipengele vipya au masomo
fix/ - Marekebisho ya hitilafu
docs/ - Mabadiliko ya nyaraka
refactor/ - Marekebisho ya msimbo

Miongozo ya Michango

Kwa Maudhui ya Masomo

Unapochangia masomo au kurekebisha yaliyopo:

Fuata muundo uliopo:
- README.md na maudhui ya somo
- Daftari la Jupyter na mazoezi
- Kazi (ikiwa inafaa)
- Kiungo kwa maswali ya awali na ya baada
Jumuisha vipengele hivi:
- Malengo ya kujifunza yaliyo wazi
- Maelezo ya hatua kwa hatua
- Mifano ya msimbo na maoni
- Mazoezi ya mazoezi
- Viungo kwa rasilimali za ziada
Hakikisha upatikanaji:
- Tumia lugha iliyo wazi na rahisi
- Toa maandishi mbadala kwa picha
- Jumuisha maoni ya msimbo
- Fikiria mitindo tofauti ya kujifunza

Kwa Daftari za Jupyter

Futa matokeo yote kabla ya kujitolea:

jupyter nbconvert --clear-output --inplace notebook.ipynb

Jumuisha seli za markdown na maelezo

Tumia muundo thabiti:

# Import libraries at the top
import pandas as pd
import numpy as np
import matplotlib.pyplot as plt

# Use meaningful variable names
# Add comments for complex operations
# Follow PEP 8 style guidelines

Jaribu daftari lako kikamilifu kabla ya kuwasilisha

Kwa Msimbo wa Python

Fuata miongozo ya mtindo wa PEP 8:

# Good practices
import pandas as pd

def calculate_mean(data):
    """Calculate the mean of a dataset.
    
    Args:
        data (list): List of numerical values
        
    Returns:
        float: Mean of the dataset
    """
    return sum(data) / len(data)

Kwa Michango ya Programu ya Maswali

Unapobadilisha programu ya maswali:

Jaribu kwa ndani:
```
cd quiz-app
npm install
npm run serve
```
Run linter:
```
npm run lint
```
Jenga kwa mafanikio:
```
npm run build
```
Fuata mwongozo wa mtindo wa Vue.js na mifumo iliyopo

Kwa Tafsiri

Unapoongeza au kusasisha tafsiri:

Fuata muundo katika folda ya translations/
Tumia msimbo wa lugha kama jina la folda (mfano, fr kwa Kifaransa)
Dumisha muundo sawa wa faili kama toleo la Kiingereza
Sasisha viungo vya maswali ili kujumuisha parameter ya lugha: ?loc=fr
Jaribu viungo vyote na muundo

Mchakato wa Pull Request

Kabla ya Kuwasilisha

Sasisha tawi lako na mabadiliko ya hivi karibuni:
```
git fetch upstream
git rebase upstream/main
```
Jaribu mabadiliko yako:
- Run daftari zote zilizorekebishwa
- Jaribu programu ya maswali ikiwa imebadilishwa
- Hakikisha viungo vyote vinafanya kazi
- Angalia makosa ya tahajia na sarufi
Jitolee mabadiliko yako:
```
git add .
git commit -m "Brief description of changes"
```
Andika ujumbe wa kujitolea ulio wazi:
- Tumia wakati wa sasa ("Ongeza kipengele" si "Imeongeza kipengele")
- Tumia hali ya amri ("Hamisha mshale hadi..." si "Inahamisha mshale hadi...")
- Punguza mstari wa kwanza hadi herufi 72
- Rejelea masuala na pull requests inapofaa

Push kwa fork yako:

git push origin feature/your-feature-name

Kuunda Pull Request

Nenda kwenye hifadhi
Bonyeza "Pull requests" → "New pull request"
Bonyeza "compare across forks"
Chagua fork yako na tawi
Bonyeza "Create pull request"

Muundo wa Kichwa cha PR

Tumia vichwa vilivyo wazi na vya kuelezea kufuata muundo huu:

[Component] Brief description

Mifano:

[Lesson 7] Rekebisha hitilafu ya uingizaji wa daftari la Python
[Quiz App] Ongeza tafsiri ya Kijerumani
[Docs] Sasisha README na mahitaji mapya
[Fix] Rekebisha njia ya data katika somo la taswira

Maelezo ya PR

Jumuisha katika maelezo ya PR yako:

Nini: Mabadiliko gani umefanya?
Kwa nini: Kwa nini mabadiliko haya ni muhimu?
Jinsi: Umefanyaje mabadiliko haya?
Upimaji: Umejaribuje mabadiliko haya?
Picha za skrini: Jumuisha picha za skrini kwa mabadiliko ya kuona
Masuala Yanayohusiana: Kiungo kwa masuala yanayohusiana (mfano, "Fixes #123")

Mchakato wa Mapitio

Ukaguzi wa kiotomatiki utaendeshwa kwenye PR yako
Wadumishaji watapitia mchango wako
Shughulikia maoni kwa kufanya ahadi za ziada
Mara tu imeidhinishwa, mdumishaji ataunganisha PR yako

Baada ya PR Yako Kuunganishwa

Futa tawi lako:

git branch -d feature/your-feature-name
git push origin --delete feature/your-feature-name

Sasisha fork yako:

git checkout main
git pull upstream main
git push origin main

Miongozo ya Mtindo

Markdown

Tumia viwango thabiti vya vichwa
Jumuisha mistari tupu kati ya sehemu
Tumia vizuizi vya msimbo na viainishi vya lugha:
```
```python
import pandas as pd
```
```
Ongeza maandishi mbadala kwa picha: ![Alt text](../../translated_images/sw/image.4ee84a82b5e4c9e6651b13fd27dcf615e427ec584929f2cef7167aa99151a77a.png)
Dumisha urefu wa mistari unaofaa (karibu herufi 80-100)

Python

Fuata mwongozo wa mtindo wa PEP 8
Tumia majina ya kutofautisha ya vigezo
Ongeza docstrings kwa kazi

Jumuisha vidokezo vya aina inapofaa:

def process_data(df: pd.DataFrame) -> pd.DataFrame:
    """Process the input dataframe."""
    return df

JavaScript/Vue.js

Fuata mwongozo wa mtindo wa Vue.js 2
Tumia usanidi wa ESLint uliotolewa
Andika vipengele vya modular, vinavyoweza kutumika tena
Ongeza maoni kwa mantiki ngumu

Mpangilio wa Faili

Weka faili zinazohusiana pamoja
Tumia majina ya faili yanayoelezea
Fuata muundo wa saraka uliopo
Usijitolee faili zisizo za lazima (.DS_Store, .pyc, node_modules, nk.)

Mkataba wa Leseni ya Mchangiaji

Mradi huu unakaribisha michango na mapendekezo. Michango mingi inahitaji wewe kukubali Mkataba wa Leseni ya Mchangiaji (CLA) unaotangaza kwamba una haki ya, na kwa kweli unatoa, haki kwetu kutumia mchango wako. Kwa maelezo, tembelea https://cla.microsoft.com.

Unapowasilisha pull request, CLA-bot itaamua kiotomatiki ikiwa unahitaji kutoa CLA na kupamba PR ipasavyo (mfano, lebo, maoni). Fuata tu maelekezo yaliyotolewa na bot. Utahitaji kufanya hivyo mara moja tu katika hifadhi zote zinazotumia CLA yetu.

Maswali?

Angalia Kituo chetu cha Discord #data-science-for-beginners
Jiunge na jamii yetu ya Discord
Pitia masuala yaliyopo issues na pull requests

Asante!

Michango yako inafanya mtaala huu kuwa bora kwa kila mtu. Asante kwa kuchukua muda kuchangia!

Kanusho:
Hati hii imetafsiriwa kwa kutumia huduma ya tafsiri ya AI Co-op Translator. Ingawa tunajitahidi kuhakikisha usahihi, tafadhali fahamu kuwa tafsiri za kiotomatiki zinaweza kuwa na makosa au kutokuwa sahihi. Hati ya asili katika lugha yake ya awali inapaswa kuzingatiwa kama chanzo rasmi. Kwa taarifa muhimu, tafsiri ya kitaalamu ya binadamu inapendekezwa. Hatutawajibika kwa kutoelewana au tafsiri zisizo sahihi zinazotokana na matumizi ya tafsiri hii.

10 KiB Raw Blame History