Summary  
This chapter covers how to compose clear, concise, and well-structured commit messages by separating the subject from the body, using the imperative mood, and providing sufficient context for each change.  

General domain of usage  
Source code version control (e.g., Git)

## Miksi commit-viestit ovat tärkeitä

**Commit-viestit** ovat olennaisia projektin historian ymmärtämisessä.
Selkeät ja merkitykselliset viestit auttavat yhteistyökumppaneita, tulevia kehittäjiä ja sinua itseäsi hahmottamaan kunkin muutoksen **tarkoituksen** ja **kontekstin**.
Hyvin jäsennelty **commit-historia** parantaa yhteistyötä, helpottaa virheiden korjaamista ja tekee yksittäisten muutosten jäljittämisestä projektin aikajanalla helpompaa.


## Hyvän commit-viestin rakenne
### 1. Ytimekkyys ja selkeys
**Commit-viestin** tulee olla ytimekäs ja suoraan asiaan menevä. Sen tulee selkeästi ilmaista commitin tarkoitus yhdellä rivillä. Vältä **epäselvyyttä** ja anna riittävästi tietoa muutoksen ymmärtämiseksi ilman, että koodia tarvitsee tarkastella.
```text
Bad: "Fixed a bug"
Good: "Fix issue with user authentication in login form"
```


### 2. Otsikon ja rungon erottaminen
Jos tarvitaan lisätietoja, erottele **otsikko** ja **runkoteksti** commit-viestissä tyhjällä rivillä. **Otsikon** tulee tiivistää muutos, ja **rungossa** voi antaa lisäkontekstia, perustelut muutokselle ja muuta olennaista tietoa.

Tarkastellaan esimerkkiä tällaisesta commit-viestistä:
```text
Subject: "Add validation for user email input"

Body: "This commit introduces email format validation to ensure
that users provide a valid email address when registering. It
helps improve the overall data integrity of the system."
```
Tässä tapauksessa suorita `git commit` -komento ilman `-m`-lippua:
```
git commit
```

Gitin oletuksena avautuva **tekstieditori**, jossa voi kirjoittaa yksityiskohtaisen commit-viestin. Tämän jälkeen viesti tulee **tallentaa** ja **sulkea** tekstieditori asianmukaisesti.

Tehdään seuraava commit-versionhallintaan:

Tässä on komento, jolla tekstitiedostoa muokataan:
```
echo "Git is the most popular VCS in the world used by millions of developers since it allows efficient collaboration via committing, reverting and merging changes. Besides, Git is free and open source and can be easily installed on Windows, macOS, Linux and all Unix-based platforms." >> test.txt
```

Commit-viesti seuraavasti:
```
Subject: "Add description of Git"
  
Body: "This commit introduces brief description 
of Git and highlights its key features. It also 
states the reasons for the widespread popularity 
of Git."
```

Jos et voi muokata tiedostoa, paina **i**-näppäintä. Tämä varmistaa, että siirryt muokkaustilaan. Kun haluat tallentaa muutokset ja poistua Vimistä, paina **Escape**-näppäintä ja kaksi kertaa isoa **Z**-kirjainta.

Jos käytössäsi on jokin muu oletustekstieditori terminaalissa (kuin Vim) ja kohtaat ongelmia, löydät helposti ohjeet muutosten tallentamiseen ja editorista poistumiseen internetistä.

Huomio

### 3. Käytä imperatiivimuotoa
Kirjoita commit-viestit **imperatiivimuodossa**, mikä antaa muutokselle suunnan. Aloita aihe **verbillä**, kuten "Fix", "Add" tai "Update".
```text
Bad: "Fixed the issue with the login form"
Good: "Fix issue with user authentication in login form"
```

Mikä lähestymistapa osoittaa parhaiten tiiviyttä ja selkeyttä commit-viestissä?

Git on suosituin versionhallintajärjestelmä, jota miljoonat kehittäjät käyttävät maailmanlaajuisesti. Olitpa kokenut kehittäjä tai aloittelija, tämä kurssi antaa sinulle tiedot ja taidot ohjelmistoprojektien tehokkaaseen hallintaan, yhteistyöhön muiden kanssa sekä versionhallinnan hallitsemiseen.

Aluksi tarjoamme yleiskatsauksen versionhallintajärjestelmiin yleisesti. Tämän jälkeen käsittelemme Gitin perusteita, kuten versionhallinnan käyttöönottoa ja muutosten tekemistä tietovarastoon.

Nyt on aika käsitellä Gitin edistyneempiä vuorovaikutustapoja, jotka parantavat tehokkuuttasi ja lisäävät mukavuutta yleisimpien Git-työnkulkujen kanssa.

Versionhallintajärjestelmänä Git mahdollistaa muutosten peruuttamisen tarvittaessa, joten nyt on aika tutustua Gitin tekniikoihin, joilla voi peruuttaa työpuun tallentamattomat muutokset, lavastetut muutokset sekä jopa peruuttaa tai korvata commitit.

Gitin haarat ovat erittäin hyödyllisiä yhteistyössä muiden kanssa, virheiden korjaamisessa tai tiettyjen ominaisuuksien kehittämisessä projektissa. Seuraavaksi käsitellään haarojen kanssa työskentelyn yksityiskohtia.