[![Open Source Love](https://firstcontributions.github.io/open-source-badges/badges/open-source-v1/open-source.svg)](https://github.com/firstcontributions/open-source-badges)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
[![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions)

# Tosaíonn Céad Cuireadh

Is é aidhm an tionscadail seo a bheith simplí agus treoraithe don tslí a ndéanann túsóirí a gcéad chuimsithe. Más mian leat do chéad chuimsiú a dhéanamh, lean na céimeanna thíos.

_Más rud é nach bhfuil tú compordach leis an líne smachta, [tá tutóirialanna anseo ag baint úsáide as uirlisí GUI](#tutorials-using-other-tools)_


<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="fork this repository" />

#### Mura bhfuil git ar do mhaisín agat, [suiteáil é](https://docs.github.com/en/get-started/quickstart/set-up-git).

## Foirgneamh an repositry a shábháil

Foirgneamh an repositry seo trí ghrúpaigh air a dhéanamh. Cliceáil ar an gcnaipe foirgneamh atá ar bharr an leathanaigh seo. Cruthóidh sé cóip d'an repositry seo in do chuntas féin.


## Clónaigh an repositry

<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="clone this repository" />

Anois, clónaigh an repositry ghrúpaithe chuig do mhaisín. Téigh go dtí do chuntas GitHub, oscail an repositry ghrúpaithe, cliceáil ar an gcnaipe cód agus ansin _cliceáil ar an íomhá ghlactha_ chuig an ghluais cóipchlibeaird.



Oscail tearma agus rith an t-ordú git seo a leanas:

```
git clone "url a ghlac tú amach"
```

Mar sin "url a ghlac tú amach" (gan na tréimhseanna quoitimh) is ea url chuig an repositry seo (do ghruapa den tionscadal seo). Féach ar na céimeanna roimhe sin chun an url a fháil.

<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="copy URL to clipboard" />

Mar shampla:

```
git clone git@github.com:this-is-you/first-contributions.git
```

Ait a bhfuil `this-is-you` is t-ainm úsáideora GitHub. Anseo atá tú ag cóipeáil ábhar repositry first-contributions ar GitHub chuig do ríomhaire.

## Cruthaigh snáth

Athraigh go dtí comhad repositry ar do ríomhaire (mura bhfuil tú ansin cheana):

```
cd first-contributions
```

nois cruthaigh snáth ag baint úsáide as an comhad `git switch`:

```
git switch -c your-new-branch-name
```

Mar shampla:

```
git switch -c add-alonzo-church
```

## Déan na hathruithe riachtanacha agus déan comhaireamh orthu

Anois, oscail `Contributors.md` i eagarthóir téacs, cuir do ainm leis. Ná cuir é ag tús ná ag deireadh an chomhad. Cuir é in aon áit ina lár. Ansin, sábháil an comhad.


<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="git status" />

Más téann tú go dtí comhaid tionscadail agus déanann tú an t-ordú `git status`, feicfidh tú go bhfuil athruithe ann.

Cuir na hathruithe sin leis an snáth a chruthaigh tú leis an gcnaipe `git add`:

```
git add Contributors.md
```

Ansin déan comhaireamh orthu leis an gcnaipe `git commit`:

```
git commit -m "Add your-name to Contributors list"
```

agus cuir in áit do ainm in ionad `your-name`.

## Seol athruithe chuig GitHub

Seol do chuid athruithe ag baint úsáide as an gcnaipe `git push`:

```
git push -u origin your-branch-name
```


agus cuir `your-branch-name` do snátha a chruthaigh tú roimhe seo.
<details>
<summary> <strong>Má fhaigheann tú botúin ar bith le linn an athsheoladh, cliceáil anseo:</strong> </summary>

- ### Authentication Error
     <pre>remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead.
  remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information.
  fatal: Authentication failed for 'https://github.com/<your-username>/first-contributions.git/'</pre>
  Go to [GitHub's tutorial](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account) on generating and configuring an SSH key to your account.

</details>

## Cuimhnigh ort do chuid athruithe a chur chun athbhreithnithe

Má téann tú go dtí do repositry ar GitHub, feicfidh tú cnaipe `Compare & pull request`. Cliceáil ar an gcnaipe sin.


<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />

Ansin cuir isteach an iarratas athbhreithnithe.

<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="submit pull request" />

Go luath beidh mé ag méascadh na hathruithe uile atá déanta agat isteach i mbranca príomh an tionscadail seo. Beidh ríomhphost fógra agat nuair a bheidh na hathruithe comhoiriúnaithe.


## Cá háit a leantú as seo amach?

Comhghairdeas! Chríochnaigh tú an tslí ríthábhachtach  _fork -> clone -> edit -> pull request_ iarratas ar athbhreithniú a bhíonn ag tionscalóirí go minic!


Ceiliúraigh do chionta agus roinne é le do chairde agus le do leanúnaigh trí dul go dtí an aip ghréasáin. [web app](https://firstcontributions.github.io/#social-share).

D'fhéadfá dul inár bhfoireann Slack má tá cabhair uait nó ceisteanna agat. [Ghabh le foireann Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1n4y7xnk0-DnLVTaN6U9xLU79H5Hi62w).

Anois, lig dúinn tú a thosú ag tacú le tionscadail eile. Tá liosta againn de thionscadail le faidhéideanna éasca a d'fhéadfá tosú orthu. Féach ar liosta na dtionscadal san aip ghréasáin.

Anois, lig dúinn tú a thosú ag tacú le tionscadail eile. Tá liosta againn de thionscadail le faidhéideanna éasca a d'fhéadfá tosú orthu. Féach ar [liosta na dtionscadal san aip ghréasáin](https://firstcontributions.github.io/#project-list).

### [Ábhar Breise](additional-material/git_workflow_scenarios/additional-material.md)

## Tutóirialanna Ag Úsáid Uirlisí Eile

| <a href="gui-tool-tutorials/github-desktop-tutorial.md"><img alt="GitHub Desktop" src="https://desktop.github.com/images/desktop-icon.svg" width="100"></a> | <a href="gui-tool-tutorials/github-windows-vs2017-tutorial.md"><img alt="Visual Studio 2017" src="https://upload.wikimedia.org/wikipedia/commons/c/cd/Visual_Studio_2017_Logo.svg" width="100"></a> | <a href="gui-tool-tutorials/gitkraken-tutorial.md"><img alt="GitKraken" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/gitkraken-tutorial/gk-icon.png" width="100"></a> | <a href="gui-tool-tutorials/github-windows-vs-code-tutorial.md"><img alt="VS Code" src="https://upload.wikimedia.org/wikipedia/commons/1/1c/Visual_Studio_Code_1.35_icon.png" width=100></a> | <a href="gui-tool-tutorials/sourcetree-macos-tutorial.md"><img alt="Sourcetree App" src="https://wac-cdn.atlassian.com/dam/jcr:81b15cde-be2e-4f4a-8af7-9436f4a1b431/Sourcetree-icon-blue.svg" width=100></a> | <a href="gui-tool-tutorials/github-windows-intellij-tutorial.md"><img alt="IntelliJ IDEA" src="https://upload.wikimedia.org/wikipedia/commons/thumb/9/9c/IntelliJ_IDEA_Icon.svg/512px-IntelliJ_IDEA_Icon.svg.png" width=100></a> |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [GitHub Desktop](gui-tool-tutorials/github-desktop-tutorial.md)                                                                                             | [Visual Studio 2017](gui-tool-tutorials/github-windows-vs2017-tutorial.md)                                                                                                                          | [GitKraken](gui-tool-tutorials/gitkraken-tutorial.md)                                                                                                                                        | [Visual Studio Code](gui-tool-tutorials/github-windows-vs-code-tutorial.md)                                                                                                                  | [Atlassian Sourcetree](gui-tool-tutorials/sourcetree-macos-tutorial.md)                                                                                                                                      | [IntelliJ IDEA](gui-tool-tutorials/github-windows-intellij-tutorial.md)                                                                                                                                                          |

<p>Tugann tacaíocht don tionscadal seo::</p>
<p>
  <a href="https://www.digitalocean.com/">
    <img src="https://opensource.nyc3.cdn.digitaloceanspaces.com/attribution/assets/SVG/DO_Logo_horizontal_blue.svg" width="201px">
  </a>
</p>
