[](https://github.com/firstcontributions/open-source-badges)
[](https://opensource.org/licenses/MIT)
[](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)_
#### 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
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.
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.
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.
Má fhaigheann tú botúin ar bith le linn an athsheoladh, cliceáil anseo:
- ### Authentication Error
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/
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.
Ansin cuir isteach an iarratas athbhreithnithe.
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
| |
|
|
| |
|
| ----------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [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) |
Tugann tacaíocht don tionscadal seo::