├── .github └── ISSUE_TEMPLATE │ ├── bug_report.md │ └── feature_request.md ├── .gitignore ├── LICENSE ├── README.md ├── config.yml ├── course-details.md ├── responses ├── 00_assign-yourself.md ├── 00_introduction.md ├── 01_turn-on-gh-pages.md ├── 02_close-issue.md ├── 03_create-a-branch.md ├── 03_head-to-branch.md ├── 03_your-first-contribution.md ├── 04_commit-something.md ├── 05_open-a-pr.md ├── 06_fix-base.md ├── 06_fix-body.md ├── 06_fix-filename.md ├── 06_request-changes.md ├── 07_pr-succeeds.md ├── 08_reminder-delete.md ├── 08_reopen.md ├── es │ ├── 00_assign-yourself.md │ ├── 00_introduction.md │ ├── 01_turn-on-gh-pages.md │ ├── 02_close-issue.md │ ├── 03_create-a-branch.md │ ├── 03_head-to-branch.md │ ├── 03_your-first-contribution.md │ ├── 04_commit-something.md │ ├── 05_open-a-pr.md │ ├── 06_fix-base.md │ ├── 06_fix-body.md │ ├── 06_fix-filename.md │ ├── 06_request-changes.md │ ├── 07_pr-succeeds.md │ ├── 08_reminder-delete.md │ └── 08_reopen.md ├── fr │ ├── 00_assign-yourself.md │ ├── 00_introduction.md │ ├── 01_turn-on-gh-pages.md │ ├── 02_close-issue.md │ ├── 03_create-a-branch.md │ ├── 03_head-to-branch.md │ ├── 03_your-first-contribution.md │ ├── 04_commit-something.md │ ├── 05_open-a-pr.md │ ├── 06_fix-base.md │ ├── 06_fix-body.md │ ├── 06_fix-filename.md │ ├── 06_request-changes.md │ ├── 07_pr-succeeds.md │ ├── 08_reminder-delete.md │ └── 08_reopen.md └── ja │ ├── 00_assign-yourself.md │ ├── 00_introduction.md │ ├── 01_turn-on-gh-pages.md │ ├── 02_close-issue.md │ ├── 03_create-a-branch.md │ ├── 03_head-to-branch.md │ ├── 03_your-first-contribution.md │ ├── 04_commit-something.md │ ├── 05_open-a-pr.md │ ├── 06_fix-base.md │ ├── 06_fix-body.md │ ├── 06_fix-filename.md │ ├── 06_request-changes.md │ ├── 07_pr-succeeds.md │ ├── 08_reminder-delete.md │ └── 08_reopen.md └── server-installation-notes.md /.github/ISSUE_TEMPLATE/bug_report.md: -------------------------------------------------------------------------------- 1 | --- 2 | name: Bug Report 3 | about: Is something not working as expected? Please help us improve! 4 | title: '' 5 | labels: 'bug' 6 | --- 7 | 8 | ## Bug Report 9 | 10 | **Current behavior** 11 | A clear and concise description of what the bug is (with screenshots). 12 | 13 | **Reproduction** 14 | Steps to reproduce the behavior in the course: 15 | 1. Go to '...' 16 | 2. Click on '....' 17 | 3. Scroll down to '....' 18 | 4. See error 19 | 20 | **Expected behavior** 21 | A clear and concise description of what you expected to happen. 22 | 23 | **Possible solution** 24 | If you have suggestions, we'd love to hear them. If not, that's ok too. 25 | 26 | **Additional context** 27 | Add any other context about the problem here. If applicable, add screenshots to help explain. 28 | -------------------------------------------------------------------------------- /.github/ISSUE_TEMPLATE/feature_request.md: -------------------------------------------------------------------------------- 1 | --- 2 | name: Feature Request 3 | about: I have a suggestion... and may want to implement it! 4 | title: '' 5 | labels: 'enhancement' 6 | --- 7 | 8 | ## Feature Request 9 | 10 | **Describe the problem/friction you are trying to solve** 11 | A clear and concise description of what the problem is, e.g. I am always frustrated when... 12 | 13 | **Describe your ideal solution** 14 | A clear and concise description of what you want to happen, ideally including code snippets to demonstrate usage examples. 15 | 16 | Add any considered drawbacks. 17 | 18 | **Describe alternatives you have considered** 19 | A clear and concise description of any alternative solutions or features you have considered. 20 | -------------------------------------------------------------------------------- /.gitignore: -------------------------------------------------------------------------------- 1 | .DS_Store -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | Attribution 4.0 International 2 | 3 | ======================================================================= 4 | 5 | Creative Commons Corporation ("Creative Commons") is not a law firm and 6 | does not provide legal services or legal advice. Distribution of 7 | Creative Commons public licenses does not create a lawyer-client or 8 | other relationship. Creative Commons makes its licenses and related 9 | information available on an "as-is" basis. Creative Commons gives no 10 | warranties regarding its licenses, any material licensed under their 11 | terms and conditions, or any related information. Creative Commons 12 | disclaims all liability for damages resulting from their use to the 13 | fullest extent possible. 14 | 15 | Using Creative Commons Public Licenses 16 | 17 | Creative Commons public licenses provide a standard set of terms and 18 | conditions that creators and other rights holders may use to share 19 | original works of authorship and other material subject to copyright 20 | and certain other rights specified in the public license below. The 21 | following considerations are for informational purposes only, are not 22 | exhaustive, and do not form part of our licenses. 23 | 24 | Considerations for licensors: Our public licenses are 25 | intended for use by those authorized to give the public 26 | permission to use material in ways otherwise restricted by 27 | copyright and certain other rights. Our licenses are 28 | irrevocable. Licensors should read and understand the terms 29 | and conditions of the license they choose before applying it. 30 | Licensors should also secure all rights necessary before 31 | applying our licenses so that the public can reuse the 32 | material as expected. Licensors should clearly mark any 33 | material not subject to the license. This includes other CC- 34 | licensed material, or material used under an exception or 35 | limitation to copyright. More considerations for licensors: 36 | wiki.creativecommons.org/Considerations_for_licensors 37 | 38 | Considerations for the public: By using one of our public 39 | licenses, a licensor grants the public permission to use the 40 | licensed material under specified terms and conditions. If 41 | the licensor's permission is not necessary for any reason--for 42 | example, because of any applicable exception or limitation to 43 | copyright--then that use is not regulated by the license. Our 44 | licenses grant only permissions under copyright and certain 45 | other rights that a licensor has authority to grant. Use of 46 | the licensed material may still be restricted for other 47 | reasons, including because others have copyright or other 48 | rights in the material. A licensor may make special requests, 49 | such as asking that all changes be marked or described. 50 | Although not required by our licenses, you are encouraged to 51 | respect those requests where reasonable. More considerations 52 | for the public: 53 | wiki.creativecommons.org/Considerations_for_licensees 54 | 55 | ======================================================================= 56 | 57 | Creative Commons Attribution 4.0 International Public License 58 | 59 | By exercising the Licensed Rights (defined below), You accept and agree 60 | to be bound by the terms and conditions of this Creative Commons 61 | Attribution 4.0 International Public License ("Public License"). To the 62 | extent this Public License may be interpreted as a contract, You are 63 | granted the Licensed Rights in consideration of Your acceptance of 64 | these terms and conditions, and the Licensor grants You such rights in 65 | consideration of benefits the Licensor receives from making the 66 | Licensed Material available under these terms and conditions. 67 | 68 | 69 | Section 1 -- Definitions. 70 | 71 | a. Adapted Material means material subject to Copyright and Similar 72 | Rights that is derived from or based upon the Licensed Material 73 | and in which the Licensed Material is translated, altered, 74 | arranged, transformed, or otherwise modified in a manner requiring 75 | permission under the Copyright and Similar Rights held by the 76 | Licensor. For purposes of this Public License, where the Licensed 77 | Material is a musical work, performance, or sound recording, 78 | Adapted Material is always produced where the Licensed Material is 79 | synched in timed relation with a moving image. 80 | 81 | b. Adapter's License means the license You apply to Your Copyright 82 | and Similar Rights in Your contributions to Adapted Material in 83 | accordance with the terms and conditions of this Public License. 84 | 85 | c. Copyright and Similar Rights means copyright and/or similar rights 86 | closely related to copyright including, without limitation, 87 | performance, broadcast, sound recording, and Sui Generis Database 88 | Rights, without regard to how the rights are labeled or 89 | categorized. For purposes of this Public License, the rights 90 | specified in Section 2(b)(1)-(2) are not Copyright and Similar 91 | Rights. 92 | 93 | d. Effective Technological Measures means those measures that, in the 94 | absence of proper authority, may not be circumvented under laws 95 | fulfilling obligations under Article 11 of the WIPO Copyright 96 | Treaty adopted on December 20, 1996, and/or similar international 97 | agreements. 98 | 99 | e. Exceptions and Limitations means fair use, fair dealing, and/or 100 | any other exception or limitation to Copyright and Similar Rights 101 | that applies to Your use of the Licensed Material. 102 | 103 | f. Licensed Material means the artistic or literary work, database, 104 | or other material to which the Licensor applied this Public 105 | License. 106 | 107 | g. Licensed Rights means the rights granted to You subject to the 108 | terms and conditions of this Public License, which are limited to 109 | all Copyright and Similar Rights that apply to Your use of the 110 | Licensed Material and that the Licensor has authority to license. 111 | 112 | h. Licensor means the individual(s) or entity(ies) granting rights 113 | under this Public License. 114 | 115 | i. Share means to provide material to the public by any means or 116 | process that requires permission under the Licensed Rights, such 117 | as reproduction, public display, public performance, distribution, 118 | dissemination, communication, or importation, and to make material 119 | available to the public including in ways that members of the 120 | public may access the material from a place and at a time 121 | individually chosen by them. 122 | 123 | j. Sui Generis Database Rights means rights other than copyright 124 | resulting from Directive 96/9/EC of the European Parliament and of 125 | the Council of 11 March 1996 on the legal protection of databases, 126 | as amended and/or succeeded, as well as other essentially 127 | equivalent rights anywhere in the world. 128 | 129 | k. You means the individual or entity exercising the Licensed Rights 130 | under this Public License. Your has a corresponding meaning. 131 | 132 | 133 | Section 2 -- Scope. 134 | 135 | a. License grant. 136 | 137 | 1. Subject to the terms and conditions of this Public License, 138 | the Licensor hereby grants You a worldwide, royalty-free, 139 | non-sublicensable, non-exclusive, irrevocable license to 140 | exercise the Licensed Rights in the Licensed Material to: 141 | 142 | a. reproduce and Share the Licensed Material, in whole or 143 | in part; and 144 | 145 | b. produce, reproduce, and Share Adapted Material. 146 | 147 | 2. Exceptions and Limitations. For the avoidance of doubt, where 148 | Exceptions and Limitations apply to Your use, this Public 149 | License does not apply, and You do not need to comply with 150 | its terms and conditions. 151 | 152 | 3. Term. The term of this Public License is specified in Section 153 | 6(a). 154 | 155 | 4. Media and formats; technical modifications allowed. The 156 | Licensor authorizes You to exercise the Licensed Rights in 157 | all media and formats whether now known or hereafter created, 158 | and to make technical modifications necessary to do so. The 159 | Licensor waives and/or agrees not to assert any right or 160 | authority to forbid You from making technical modifications 161 | necessary to exercise the Licensed Rights, including 162 | technical modifications necessary to circumvent Effective 163 | Technological Measures. For purposes of this Public License, 164 | simply making modifications authorized by this Section 2(a) 165 | (4) never produces Adapted Material. 166 | 167 | 5. Downstream recipients. 168 | 169 | a. Offer from the Licensor -- Licensed Material. Every 170 | recipient of the Licensed Material automatically 171 | receives an offer from the Licensor to exercise the 172 | Licensed Rights under the terms and conditions of this 173 | Public License. 174 | 175 | b. No downstream restrictions. You may not offer or impose 176 | any additional or different terms or conditions on, or 177 | apply any Effective Technological Measures to, the 178 | Licensed Material if doing so restricts exercise of the 179 | Licensed Rights by any recipient of the Licensed 180 | Material. 181 | 182 | 6. No endorsement. Nothing in this Public License constitutes or 183 | may be construed as permission to assert or imply that You 184 | are, or that Your use of the Licensed Material is, connected 185 | with, or sponsored, endorsed, or granted official status by, 186 | the Licensor or others designated to receive attribution as 187 | provided in Section 3(a)(1)(A)(i). 188 | 189 | b. Other rights. 190 | 191 | 1. Moral rights, such as the right of integrity, are not 192 | licensed under this Public License, nor are publicity, 193 | privacy, and/or other similar personality rights; however, to 194 | the extent possible, the Licensor waives and/or agrees not to 195 | assert any such rights held by the Licensor to the limited 196 | extent necessary to allow You to exercise the Licensed 197 | Rights, but not otherwise. 198 | 199 | 2. Patent and trademark rights are not licensed under this 200 | Public License. 201 | 202 | 3. To the extent possible, the Licensor waives any right to 203 | collect royalties from You for the exercise of the Licensed 204 | Rights, whether directly or through a collecting society 205 | under any voluntary or waivable statutory or compulsory 206 | licensing scheme. In all other cases the Licensor expressly 207 | reserves any right to collect such royalties. 208 | 209 | 210 | Section 3 -- License Conditions. 211 | 212 | Your exercise of the Licensed Rights is expressly made subject to the 213 | following conditions. 214 | 215 | a. Attribution. 216 | 217 | 1. If You Share the Licensed Material (including in modified 218 | form), You must: 219 | 220 | a. retain the following if it is supplied by the Licensor 221 | with the Licensed Material: 222 | 223 | i. identification of the creator(s) of the Licensed 224 | Material and any others designated to receive 225 | attribution, in any reasonable manner requested by 226 | the Licensor (including by pseudonym if 227 | designated); 228 | 229 | ii. a copyright notice; 230 | 231 | iii. a notice that refers to this Public License; 232 | 233 | iv. a notice that refers to the disclaimer of 234 | warranties; 235 | 236 | v. a URI or hyperlink to the Licensed Material to the 237 | extent reasonably practicable; 238 | 239 | b. indicate if You modified the Licensed Material and 240 | retain an indication of any previous modifications; and 241 | 242 | c. indicate the Licensed Material is licensed under this 243 | Public License, and include the text of, or the URI or 244 | hyperlink to, this Public License. 245 | 246 | 2. You may satisfy the conditions in Section 3(a)(1) in any 247 | reasonable manner based on the medium, means, and context in 248 | which You Share the Licensed Material. For example, it may be 249 | reasonable to satisfy the conditions by providing a URI or 250 | hyperlink to a resource that includes the required 251 | information. 252 | 253 | 3. If requested by the Licensor, You must remove any of the 254 | information required by Section 3(a)(1)(A) to the extent 255 | reasonably practicable. 256 | 257 | 4. If You Share Adapted Material You produce, the Adapter's 258 | License You apply must not prevent recipients of the Adapted 259 | Material from complying with this Public License. 260 | 261 | 262 | Section 4 -- Sui Generis Database Rights. 263 | 264 | Where the Licensed Rights include Sui Generis Database Rights that 265 | apply to Your use of the Licensed Material: 266 | 267 | a. for the avoidance of doubt, Section 2(a)(1) grants You the right 268 | to extract, reuse, reproduce, and Share all or a substantial 269 | portion of the contents of the database; 270 | 271 | b. if You include all or a substantial portion of the database 272 | contents in a database in which You have Sui Generis Database 273 | Rights, then the database in which You have Sui Generis Database 274 | Rights (but not its individual contents) is Adapted Material; and 275 | 276 | c. You must comply with the conditions in Section 3(a) if You Share 277 | all or a substantial portion of the contents of the database. 278 | 279 | For the avoidance of doubt, this Section 4 supplements and does not 280 | replace Your obligations under this Public License where the Licensed 281 | Rights include other Copyright and Similar Rights. 282 | 283 | 284 | Section 5 -- Disclaimer of Warranties and Limitation of Liability. 285 | 286 | a. UNLESS OTHERWISE SEPARATELY UNDERTAKEN BY THE LICENSOR, TO THE 287 | EXTENT POSSIBLE, THE LICENSOR OFFERS THE LICENSED MATERIAL AS-IS 288 | AND AS-AVAILABLE, AND MAKES NO REPRESENTATIONS OR WARRANTIES OF 289 | ANY KIND CONCERNING THE LICENSED MATERIAL, WHETHER EXPRESS, 290 | IMPLIED, STATUTORY, OR OTHER. THIS INCLUDES, WITHOUT LIMITATION, 291 | WARRANTIES OF TITLE, MERCHANTABILITY, FITNESS FOR A PARTICULAR 292 | PURPOSE, NON-INFRINGEMENT, ABSENCE OF LATENT OR OTHER DEFECTS, 293 | ACCURACY, OR THE PRESENCE OR ABSENCE OF ERRORS, WHETHER OR NOT 294 | KNOWN OR DISCOVERABLE. WHERE DISCLAIMERS OF WARRANTIES ARE NOT 295 | ALLOWED IN FULL OR IN PART, THIS DISCLAIMER MAY NOT APPLY TO YOU. 296 | 297 | b. TO THE EXTENT POSSIBLE, IN NO EVENT WILL THE LICENSOR BE LIABLE 298 | TO YOU ON ANY LEGAL THEORY (INCLUDING, WITHOUT LIMITATION, 299 | NEGLIGENCE) OR OTHERWISE FOR ANY DIRECT, SPECIAL, INDIRECT, 300 | INCIDENTAL, CONSEQUENTIAL, PUNITIVE, EXEMPLARY, OR OTHER LOSSES, 301 | COSTS, EXPENSES, OR DAMAGES ARISING OUT OF THIS PUBLIC LICENSE OR 302 | USE OF THE LICENSED MATERIAL, EVEN IF THE LICENSOR HAS BEEN 303 | ADVISED OF THE POSSIBILITY OF SUCH LOSSES, COSTS, EXPENSES, OR 304 | DAMAGES. WHERE A LIMITATION OF LIABILITY IS NOT ALLOWED IN FULL OR 305 | IN PART, THIS LIMITATION MAY NOT APPLY TO YOU. 306 | 307 | c. The disclaimer of warranties and limitation of liability provided 308 | above shall be interpreted in a manner that, to the extent 309 | possible, most closely approximates an absolute disclaimer and 310 | waiver of all liability. 311 | 312 | 313 | Section 6 -- Term and Termination. 314 | 315 | a. This Public License applies for the term of the Copyright and 316 | Similar Rights licensed here. However, if You fail to comply with 317 | this Public License, then Your rights under this Public License 318 | terminate automatically. 319 | 320 | b. Where Your right to use the Licensed Material has terminated under 321 | Section 6(a), it reinstates: 322 | 323 | 1. automatically as of the date the violation is cured, provided 324 | it is cured within 30 days of Your discovery of the 325 | violation; or 326 | 327 | 2. upon express reinstatement by the Licensor. 328 | 329 | For the avoidance of doubt, this Section 6(b) does not affect any 330 | right the Licensor may have to seek remedies for Your violations 331 | of this Public License. 332 | 333 | c. For the avoidance of doubt, the Licensor may also offer the 334 | Licensed Material under separate terms or conditions or stop 335 | distributing the Licensed Material at any time; however, doing so 336 | will not terminate this Public License. 337 | 338 | d. Sections 1, 5, 6, 7, and 8 survive termination of this Public 339 | License. 340 | 341 | 342 | Section 7 -- Other Terms and Conditions. 343 | 344 | a. The Licensor shall not be bound by any additional or different 345 | terms or conditions communicated by You unless expressly agreed. 346 | 347 | b. Any arrangements, understandings, or agreements regarding the 348 | Licensed Material not stated herein are separate from and 349 | independent of the terms and conditions of this Public License. 350 | 351 | 352 | Section 8 -- Interpretation. 353 | 354 | a. For the avoidance of doubt, this Public License does not, and 355 | shall not be interpreted to, reduce, limit, restrict, or impose 356 | conditions on any use of the Licensed Material that could lawfully 357 | be made without permission under this Public License. 358 | 359 | b. To the extent possible, if any provision of this Public License is 360 | deemed unenforceable, it shall be automatically reformed to the 361 | minimum extent necessary to make it enforceable. If the provision 362 | cannot be reformed, it shall be severed from this Public License 363 | without affecting the enforceability of the remaining terms and 364 | conditions. 365 | 366 | c. No term or condition of this Public License will be waived and no 367 | failure to comply consented to unless expressly agreed to by the 368 | Licensor. 369 | 370 | d. Nothing in this Public License constitutes or may be interpreted 371 | as a limitation upon, or waiver of, any privileges and immunities 372 | that apply to the Licensor or You, including from the legal 373 | processes of any jurisdiction or authority. 374 | 375 | 376 | ======================================================================= 377 | 378 | Creative Commons is not a party to its public 379 | licenses. Notwithstanding, Creative Commons may elect to apply one of 380 | its public licenses to material it publishes and in those instances 381 | will be considered the “Licensor.” The text of the Creative Commons 382 | public licenses is dedicated to the public domain under the CC0 Public 383 | Domain Dedication. Except for the limited purpose of indicating that 384 | material is shared under a Creative Commons public license or as 385 | otherwise permitted by the Creative Commons policies published at 386 | creativecommons.org/policies, Creative Commons does not authorize the 387 | use of the trademark "Creative Commons" or any other trademark or logo 388 | of Creative Commons without its prior written consent including, 389 | without limitation, in connection with any unauthorized modifications 390 | to any of its public licenses or any other arrangements, 391 | understandings, or agreements concerning use of licensed material. For 392 | the avoidance of doubt, this paragraph does not form part of the 393 | public licenses. 394 | 395 | Creative Commons may be contacted at creativecommons.org. 396 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 |

Learning Lab bot

2 | 3 |

Course: Introduction to GitHub

4 | 5 | This repository powers the Learning Lab course [_Introduction to GitHub_](https://lab.github.com/githubtraining/introduction-to-github). 6 | 7 | Every Learning Lab course is made up of: 8 | - a [course repository](https://github.com/githubtraining/introduction-to-github), and 9 | - a [template repository](https://github.com/githubtraining/caption-this-template) 10 | 11 | The course repository is written in YAML and Markdown. The template repository could be written in any language that supports the learning objectives. 12 | 13 | For more information on the goals of this course, check out the [`course-details.md`](course-details.md). 14 | 15 | ## Contribute 16 | 17 | See something we could improve? Check out the contributing guide in the [community contributors repository](https://github.com/githubtraining/community-contributors/blob/main/CONTRIBUTING.md) for more information on the types of contributions we :heart: and instructions. 18 | 19 | We :heart: our community and take great care to ensure it is fun, safe and rewarding. Please review our [Code of Conduct](https://github.com/githubtraining/community-contributors/blob/main/CODE_OF_CONDUCT.md) for community expectations and guidelines for reporting concerns. 20 | 21 | ## License 22 | 23 | All Learning Lab course repositories are licensed under [CC-BY-4.0](../main/LICENSE) (c) 2019 GitHub, Inc. The template repositories associated with each course may have different licenses. 24 | 25 | When using the GitHub logos, be sure to follow the [GitHub logo guidelines](https://github.com/logos) 26 | -------------------------------------------------------------------------------- /config.yml: -------------------------------------------------------------------------------- 1 | title: Introduction to GitHub 2 | description: If you are looking for a quick and fun introduction to GitHub, you've found it. This class will get you started using GitHub in less than an hour. 3 | template: 4 | name: github-slideshow 5 | repo: caption-this-template 6 | description: 'A robot powered training repository :robot:' 7 | preferences: 8 | - type: radio 9 | name: gitTool 10 | label: Preferred Git tool 11 | description: Learn right from the web UI, or using your chosen tool 12 | options: 13 | - label: Use the GitHub.com web interface 14 | value: dotcom 15 | - label: Use the command line 16 | value: cli 17 | - label: Use Visual Studio Code 18 | value: vscode 19 | - type: dropdown 20 | name: language 21 | label: Language 22 | description: Choose your preferred language. 23 | options: 24 | - label: English 25 | value: en 26 | - label: Español 27 | value: es 28 | - label: 日本語 29 | value: ja 30 | - label: Français 31 | value: fr 32 | before: 33 | - type: updateBranchProtection 34 | - type: createIssue 35 | title: Getting Started with GitHub 36 | body: 00_introduction.md 37 | comments: 38 | - 00_assign-yourself.md 39 | 40 | # Course artifacts: 41 | # 1. Issue: Getting started with GitHub 42 | # 2. Issue: Your first contribution 43 | # 3. PR: [Created by learner] 44 | 45 | steps: 46 | 47 | # 1 48 | - title: Assign yourself 49 | description: Assign the first issue to yourself. 50 | translations: 51 | es: 52 | title: Asígnate 53 | description: Asígnate la primera propuesta. 54 | fr: 55 | title: Assignation 56 | description: Assignez-vous la première Issue. 57 | ja: 58 | title: 担当者になろう 59 | description: 初めてのイシューの担当者になりましょう。 60 | event: issues.assigned 61 | link: '{{ repoUrl }}/issues/1' 62 | actions: 63 | - type: gate 64 | left: '%payload.assignee.login%' 65 | operator: === 66 | right: '%user.username%' 67 | - type: respond 68 | with: 01_turn-on-gh-pages.md 69 | 70 | # 2 71 | - title: Turn on GitHub Pages 72 | description: Turn on GitHub Pages in the settings page of the repository. 73 | translations: 74 | es: 75 | title: Activa GitHub Pages 76 | description: Activa GitHub Pages en la página de configuración del repositorio. 77 | fr: 78 | title: Activation de GitHub Pages 79 | description: Activez GitHub Pages sur la page de configuration du dépôt. 80 | ja: 81 | title: GitHub Pagesを有効化しよう 82 | description: リポジトリの設定画面でGitHub Pagesを有効化しましましょう。 83 | event: page_build 84 | link: '{{ repoUrl }}/issues/1' 85 | actions: 86 | - type: octokit 87 | method: repos.getPages 88 | owner: '%payload.repository.owner.login%' 89 | repo: '%payload.repository.name%' 90 | store: 91 | pagesUrl: '{{ result.data.html_url }}' 92 | action_id: pagesUrl 93 | - type: respond 94 | issue: Getting Started with GitHub 95 | with: 02_close-issue.md 96 | 97 | # 3 98 | - title: Close an issue 99 | description: Cease a conversation by closing an issue. 100 | translations: 101 | es: 102 | title: Cierra una propuesta 103 | description: Termina una conversación al cerrar una propuesta. 104 | fr: 105 | title: Fermer l'Issue 106 | description: Achevez l'Issue en la cloturant. 107 | ja: 108 | title: Issueを閉じよう 109 | description: Issueを閉じることで議論を終えましょう。 110 | 111 | event: issues.closed 112 | link: '{{ repoUrl }}/issues/1' 113 | actions: 114 | - type: createIssue 115 | action_id: contrib_issue 116 | title: Your first contribution 117 | body: 03_your-first-contribution.md 118 | comments: 119 | - 03_create-a-branch.md 120 | data: 121 | thePayload: '%payload%' 122 | - type: respond 123 | with: 03_head-to-branch.md 124 | data: 125 | issueURL: '%actions.contrib_issue.data.html_url%' 126 | 127 | # 4 128 | - title: Create a branch 129 | description: Create a branch for introducing new changes. 130 | translations: 131 | es: 132 | title: Crea una rama 133 | description: Crea una rama para introducir nuevos cambios. 134 | fr: 135 | title: Création d'une branche 136 | description: Créez une branche afin d'introduire un changement. 137 | ja: 138 | title: ブランチを作ろう 139 | description: 新しい変更をするためのブランチを作りましょう。 140 | event: create 141 | link: '{{ repoUrl }}/issues/2' 142 | actions: 143 | - type: respond 144 | issue: Your first contribution 145 | with: 04_commit-something.md 146 | data: 147 | thePayload: '%payload%' 148 | 149 | # 5 150 | - title: Commit a file 151 | description: Commit your file to the branch. 152 | translations: 153 | es: 154 | title: Confirma un archivo 155 | description: Confirma un archivo a tu rama. 156 | fr: 157 | title: Soumettre un fichier 158 | description: Ajoutez un fichier à votre branche. 159 | ja: 160 | title: ファイルをコミットしよう 161 | description: ブランチにファイルをコミットしましょう。 162 | event: push 163 | link: '{{ repoUrl }}/issues/2' 164 | actions: 165 | - type: respond 166 | issue: Your first contribution 167 | with: 05_open-a-pr.md 168 | data: 169 | branch: '%payload.ref%' 170 | url: '%payload.repository.html_url%/compare/%payload.ref%?expand=1' 171 | 172 | # 6 173 | - title: Open a pull request 174 | description: Open a pull request to propose your new file to the codebase. 175 | translations: 176 | es: 177 | title: Abre una solicitud de extracción 178 | description: Abre una solicitud de extracción para proponer agregar tu nuevo archivo al proyecto. 179 | fr: 180 | title: Ouverture d'une Pull Request 181 | description: Ouvrez une Pull Request afin de proposer l'ajout de votre fichier au projet. 182 | ja: 183 | title: プルリクエストをオープンしよう 184 | description: 新しいファイルをコードベースに追加する提案をするためにプルリクエストをオープンしましょう。 185 | event: pull_request 186 | link: '{{ repoUrl }}/issues/2' 187 | actions: 188 | - type: gate 189 | gates: 190 | - left: '%payload.action%' 191 | operator: === 192 | right: opened 193 | - left: '%payload.action%' 194 | operator: === 195 | right: edited 196 | - left: '%payload.action%' 197 | operator: === 198 | right: synchronize 199 | - type: closeIssue 200 | issue: Your first contribution 201 | - type: gate 202 | left: '%payload.pull_request.body%' 203 | else: 204 | - type: createReview 205 | body: 06_fix-body.md 206 | event: REQUEST_CHANGES 207 | - type: gate 208 | left: '%payload.pull_request.base.ref%' 209 | operator: === 210 | right: main 211 | else: 212 | - type: createReview 213 | body: 06_fix-base.md 214 | event: REQUEST_CHANGES 215 | - type: getTree 216 | action_id: tree 217 | recursive: true 218 | sha: '%payload.pull_request.head.sha%' 219 | - type: gate 220 | left: '%actions.tree.data.tree%' 221 | operator: includes 222 | right: path:/_posts\/\d{4}-\d{2}-\d{2}-%user.username%\.md/ 223 | else: 224 | - type: createReview 225 | body: 06_fix-filename.md 226 | event: REQUEST_CHANGES 227 | data: 228 | expected: _posts/0000-01-02-%user.username%.md 229 | url: '%payload.pull_request.html_url%/files' 230 | - type: createReview 231 | body: 06_request-changes.md 232 | event: 'COMMENT' 233 | data: 234 | branch: '%payload.pull_request.head.ref%' 235 | url: '%payload.pull_request.html_url%/files' 236 | 237 | # 7 238 | - title: Respond to a review 239 | description: Respond to a PR review. 240 | translations: 241 | es: 242 | title: Responde a una revisión 243 | description: Responde a una revisión en tu solicitud de extracción. 244 | fr: 245 | title: Réponse à une revue 246 | description: Répondez à la relecture de votre Pull Request. 247 | ja: 248 | title: レビューに対応しよう 249 | description: プルリクエストへのレビューへの対応をしましょう。 250 | event: pull_request.synchronize 251 | link: '{{ repoUrl }}/pull/3' 252 | actions: 253 | - type: removeBranchProtection 254 | - type: createReview 255 | body: 07_pr-succeeds.md 256 | event: APPROVE 257 | data: 258 | branch: '%payload.pull_request.head.ref%' 259 | 260 | # 8 261 | - title: Merge your pull request 262 | description: Make your changes live by merging your PR. 263 | translations: 264 | es: 265 | title: Fusiona tu solicitud de extracción 266 | description: Publica tus cambios al fusionar tu solicitud de extracción. 267 | fr: 268 | title: Fusion de la Pull Request 269 | description: Livrez vos changement en fusionant votre Pull Request. 270 | ja: 271 | title: プルリクエストをマージしよう 272 | description: プルリクエストをマージすることで変更を取り込みましょう。 273 | event: pull_request.closed 274 | link: '{{ repoUrl }}/pull/3' 275 | actions: 276 | - type: gate 277 | left: '%payload.pull_request.merged%' 278 | else: 279 | - type: respond 280 | with: 08_reopen.md 281 | - type: respond 282 | with: 08_reminder-delete.md 283 | 284 | tags: [ 285 | "Git","GitHub Pages","Branches","Commits","Pull Requests" 286 | ] 287 | video: "sz6zfrQpCQg" 288 | -------------------------------------------------------------------------------- /course-details.md: -------------------------------------------------------------------------------- 1 | People use GitHub to build some of the most advanced technologies in the world. Whether you’re visualizing data or building a new game, there’s a whole community and set of tools on GitHub that can help you do it even better. 2 | 3 | Now, with GitHub Learning Lab, you’ve got a sidekick along your path to becoming an all-star developer. 4 | 5 | From managing notifications to merging pull requests, GitHub Learning Lab’s “Introduction to GitHub” course guides you through everything you need to start contributing in less than an hour. See a word you don't understand? We've included an emoji 📖 next to some key terms. Click on it to see its definition. 6 | 7 | ## What you'll learn 8 | 9 | We'll answer common questions like: 10 | - What is GitHub? 11 | - How does one use GitHub? 12 | - What are issues and pull requests? 13 | - How do you create a branch and a commit? 14 | - How do you use GitHub Pages? 15 | 16 | And when you're done you'll be able to: 17 | - Communicate in issues 18 | - Manage notifications 19 | - Create branches 20 | - Make commits 21 | - Introduce changes with pull requests 22 | - Deploy a web page to GitHub pages 23 | 24 | ## What you'll build 25 | ![a gif of a slide show running on a browser](https://user-images.githubusercontent.com/821071/120042632-79aaa600-bfd8-11eb-81c0-3c0b31776e9a.gif) 26 | 27 | - Completed [source repository](https://github.com/githubtraining/github-slideshow-demo/) 28 | - Interactive [slideshow](https://githubtraining.github.io/github-slideshow-demo/) deployed to GitHub Pages. 29 | 30 | ## Prerequisites 31 | None. This course is a great introduction for your first day on GitHub. 32 | 33 | ## Projects used 34 | This makes use of the following open source projects. Consider exploring these repos and maybe even making contributions! 35 | - [reveal.js](https://github.com/hakimel/reveal.js): A framework for creating presentations using HTML 36 | - [Jekyll](https://github.com/jekyll/jekyll): a simple, blog-aware, static site generator. 37 | 38 | ## Audience 39 | 40 | New developers, new GitHub users, users new to Git, students, managers, teams 41 | -------------------------------------------------------------------------------- /responses/00_assign-yourself.md: -------------------------------------------------------------------------------- 1 | ## Step 1: Assign yourself 2 | 3 | Unassigned issues don't have owners to look after them. When you’re assigned to an issue or pull request, it tells repository visitors and contributors that you'll be facilitating the conversation or task :muscle:. 4 | 5 | ### :keyboard: Activity 6 | 7 | 1. On the right side of the screen, under the "Assignees" section, click the gear icon and select yourself 8 | 9 | For a printable version of the steps in this course, check out the [Quick Reference Guide]({{ host }}/public/{{ course.slug }}.pdf). 10 | 11 |
12 |

I'll respond when I detect you've assigned yourself to this issue.

13 | 14 | > _Sometimes I respond too fast for the page to update! If you perform an expected action and don't see a response from me, wait a few seconds and refresh the page for your next steps._ 15 | -------------------------------------------------------------------------------- /responses/00_introduction.md: -------------------------------------------------------------------------------- 1 | # :wave: Welcome to GitHub Learning Lab's "Introduction to GitHub" 2 | 3 | To get started, I’ll guide you through some important first steps in coding and collaborating on GitHub. 4 | 5 | :point_down: _This arrow means you can expand the window! Click on them throughout the course to find more information._ 6 |
What is GitHub? 7 |
8 | 9 | ## What is GitHub? 10 | 11 | I'm glad you asked! Many people come to GitHub because they want to contribute to open source [:book:](https://help.github.com/articles/github-glossary/#open-source) projects, or they're invited by teammates or classmates who use it for their projects. Why do people use GitHub for these projects? 12 | 13 | **At its heart, GitHub is a collaboration platform.** 14 | 15 | From software to legal documents, you can count on GitHub to help you do your best work with the collaboration and security tools your team needs. With GitHub, you can keep projects completely private, invite the world to collaborate, and streamline every step of your project. 16 | 17 | **GitHub is also a powerful version control tool.** 18 | 19 | GitHub uses Git [:book:](https://help.github.com/articles/github-glossary/#git), the most popular open source version control software, to track every contribution and contributor [:book:](https://help.github.com/articles/github-glossary/#contributor) to your project--so you know exactly where every line of code came from. 20 | 21 | **GitHub helps people do much more.** 22 | 23 | GitHub is used to build some of the most advanced technologies in the world. Whether you're visualizing data or building a new game, there's a whole community and set of tools on GitHub that can get you to the next step. This course starts with the basics, but we'll dig into the rest later! 24 | 25 | :tv: [Video: What is GitHub?](https://www.youtube.com/watch?v=w3jLJU7DT5E) 26 |
27 |

28 | 29 |
Exploring a GitHub repository 30 |
31 | 32 | ## Exploring a GitHub repository 33 | 34 | :tv: [Video: Exploring a repository](https://www.youtube.com/watch?v=R8OAwrcMlRw) 35 | 36 | ### More features 37 | 38 | The video covered some of the most commonly-used features. Here are a few other items you can find in GitHub repositories: 39 | 40 | - Project boards: Create Kanban-style task tracking board within GitHub 41 | - Wiki: Create and store relevant project documentation 42 | - Insights: View a drop-down menu that contains links to analytics tools for your repository including: 43 | - Pulse: Find information about the work that has been completed and the work that’s in-progress in this project dashboard 44 | - Graphs: Graphs provide a more granular view of the repository activity including who contributed to the repository, who forked it, and when they completed the work 45 | 46 | ### Special Files 47 | 48 | In the video you learned about a special file called the README.md. Here are a few other special files you can add to your repositories: 49 | 50 | - CONTRIBUTING.md: The `CONTRIBUTING.md` is used to describe the process for contributing to the repository. A link to the `CONTRIBUTING.md` file is shown anytime someone creates a new issue or pull request. 51 | - ISSUE_TEMPLATE.md: The `ISSUE_TEMPLATE.md` is another file you can use to pre-populate the body of an issue. For example, if you always need the same types of information for bug reports, include it in the issue template, and every new issue will be opened with your recommended starter text. 52 | 53 |
54 |
55 | 56 | ### Using issues 57 | 58 | This is an issue [:book:](https://help.github.com/articles/github-glossary/#issue): a place where you can have conversations about bugs in your code, code review, and just about anything else. 59 | 60 | Issue titles are like email subject lines. They tell your collaborators what the issue is about at a glance. For example, the title of this issue is Getting Started with GitHub. 61 | 62 | 63 |
Using GitHub Issues 64 | 65 | ## Using GitHub issues 66 | 67 | Issues are used to discuss ideas, enhancements, tasks, and bugs. They make collaboration easier by: 68 | 69 | - Providing everyone (even future team members) with the complete story in one place 70 | - Allowing you to cross-link to other issues and pull requests [:book:](https://help.github.com/articles/github-glossary/#pull-request) 71 | - Creating a single, comprehensive record of how and why you made certain decisions 72 | - Allowing you to easily pull the right people and teams into a conversation with @-mentions 73 | 74 | :tv: [Video: Using issues](https://www.youtube.com/watch?v=Zhj46r5D0nQ) 75 | 76 |
77 |
78 | 79 |
Managing notifications 80 |
81 | 82 | ## Managing notifications 83 | 84 | :tv: [Video: Watching, notifications, stars, and explore](https://www.youtube.com/watch?v=ocQldxF7fMY) 85 | 86 | Once you've commented on an issue or pull request, you'll start receiving email notifications when there's activity in the thread. 87 | 88 | ### How to silence or unmute specific conversations 89 | 90 | 1. Go to the issue or pull request 91 | 2. Under _"Notifications"_, click the **Unsubscribe** button on the right to silence notifications or **Subscribe** to unmute them 92 | 93 | You'll see a short description that explains your current notification status. 94 | 95 | ### How to customize notifications in Settings 96 | 97 | 1. Click your profile icon 98 | 2. Click **Settings** 99 | 3. Click **Notifications** from the menu on the left and [adjust your notification preferences](https://help.github.com/articles/managing-notification-delivery-methods/) 100 | 101 | ### Repository notification options 102 | 103 | * **Watch**: You'll receive a notification when a new issue, pull request or comment is posted, and when an issue is closed or a pull request is merged 104 | * **Not watching**: You'll no longer receive notifications unless you're @-mentioned 105 | * **Ignore**: You'll no longer receive any notifications from the repository 106 | 107 | ### How to review notifications for the repositories you're watching 108 | 109 | 1. Click your profile icon 110 | 2. Click **Settings** 111 | 3. Click **Notification** from the menu on the left 112 | 4. Click on the [things you’re watching](https://github.com/watching) link 113 | 5. Select the **Watching** tab 114 | 6. Click the **Unwatch** button to disable notifications, or **Watch** to enable them 115 | 116 |
117 |
118 | 119 |
120 |

Keep reading below to find your first task

121 | -------------------------------------------------------------------------------- /responses/01_turn-on-gh-pages.md: -------------------------------------------------------------------------------- 1 | ## Step 2: Turn on GitHub Pages 2 | 3 | :tada: You're now the proud manager of this issue! Now that you've assigned yourself, people who drop by know that they're welcome to participate, but you'll be carrying this issue across the finish line. :sunglasses:. 4 | 5 | ### Let's use GitHub Pages 6 | 7 | Now, on to business! GitHub Pages allow you to serve a static site from a repository. We've filled this repository with some site content, but the rendered site isn't visible right now. Let's change that. 8 | 9 | ### :keyboard: Activity: Enable GitHub Pages 10 | 11 | 1. Click on the [**Settings**]({{ repoUrl }}/settings) tab in this repository 12 | 1. Scroll down to the "GitHub Pages" section 13 | 1. From the "Source" drop down, select **main branch** 14 | 15 | > Note: Even though you'll see an option to choose a theme, do not apply a theme at this point. We've protected the code so you can't make unintended changes. You'll have the opportunity to apply a theme when the course is completed. 16 | 17 |
18 |

I'll respond in this issue when I detect GitHub Pages has deployed your site.

19 | 20 | > Turning on GitHub Pages creates a deployment of your repository. I may take up to a minute to respond as I await the deployment. 21 | -------------------------------------------------------------------------------- /responses/02_close-issue.md: -------------------------------------------------------------------------------- 1 | ## Step 3: Close an issue 2 | 3 | You turned on GitHub Pages! 4 | 5 | Your site is now visible to the public. Check it out at {{ store.pagesUrl }}. 6 | 7 | Now that you’ve completed the tasks in this issue, it's time to close it! Closing an issue tells other contributors that this particular conversation or task has come to an end. 8 | 9 | ### :keyboard: Activity 10 | 11 | 1. Click the **Close issue** button below 12 | 13 |
14 |

I'll respond when you've closed this issue.

15 | -------------------------------------------------------------------------------- /responses/03_create-a-branch.md: -------------------------------------------------------------------------------- 1 | ## Step 4: Create a branch 2 | 3 | Let’s complete the first step of the GitHub flow: creating a branch [:book:](https://help.github.com/articles/github-glossary/#branch). 4 | 5 |
Creating a branch 6 | 7 | ## Creating a branch 8 | 9 | :tv: [Video: Branches](https://www.youtube.com/watch?v=xgQmu81G1yY) 10 | 11 | You just learned how to create a branch—the first step in the GitHub flow. 12 | 13 | Branches are an important part of the GitHub flow because they allow us to separate our work from the `main` branch. In other words, everyone's work is safe while you contribute. 14 | 15 | ### Tips for using branches 16 | 17 | A single project can have hundreds of branches, each suggesting a new change to the `main` branch. 18 | 19 | The best way to keep branches organized with a team is to keep them concise and short-lived. In other words, a single branch should represent a single new feature or bug fix. This reduces confusion among contributors when branches are only active for a few days before they’re merged [:book:](https://help.github.com/articles/github-glossary/#merge) into the `main` branch. 20 | 21 |
22 |
23 | 24 | ### :keyboard: Activity: Your first branch 25 | 26 | {% if preferences.gitTool == 'cli' %} 27 | 1. Open your preferred command line interface, which we'll call your shell from now on. 28 | 1. Clone this repository: 29 | ```shell 30 | git clone {{ thePayload.repository.clone_url }} 31 | ``` 32 | 1. Navigate to the repository in your shell: 33 | ```shell 34 | cd {{ thePayload.repository.name }} 35 | ``` 36 | 1. Create a branch, use whatever name you like. Feel free to use the suggested name below. 37 | ```shell 38 | git branch my-slide 39 | ``` 40 | 1. Push the branch to GitHub: 41 | ``` 42 | git push --set-upstream origin 43 | ``` 44 | 45 | {% elsif preferences.gitTool == 'vscode' %} 46 | 1. Download and open [Visual Studio Code](https://code.visualstudio.com/Download) (referred to as VS Code) if you don't already have it. 47 | 1. In VS Code, open the Command Palette using Ctrl+Shift+P on Windows, or Command ⌘+Shift+P on macOS. You can also follow [VS Code's official documentation](https://code.visualstudio.com/docs/editor/versioncontrol#_cloning-a-repository) on cloning. 48 | 1. Type: `git clone` and press Enter 49 | ![a screenshot of vs code with the command palette open](https://user-images.githubusercontent.com/16547949/53639288-bcf9ec80-3bf6-11e9-9d18-d97167168248.png) 50 | 1. Paste in the URL of the repository in the new window and press Enter: 51 | ```shell 52 | {{ thePayload.repository.clone_url }} 53 | ``` 54 | 1. Select the location in which to save the repository and click **Choose folder**. Then, open the location you selected. 55 | 1. The repository folder should now be open in your VS Code project. Click on `main` at the bottom left of the VS Code window. This will bring up the Command Palette with the commands related to Git branches. 56 | ![a screenshot of the Git branches in VS Code](https://user-images.githubusercontent.com/16547949/53639606-adc76e80-3bf7-11e9-98ac-bd41ae2b40db.png) 57 | 1. Click **Create new branch** and enter any branch name you'd like, such as `my-slide`. Then press Enter. 58 | 1. When asked to select the ref to create the branch from, select `main`. 59 | 1. Go to the Source Control view, click on the ellipsis (...) and select **Push**. Confirm the dialog box asking you to publish the branch. 60 | ![a screenshot of the source control view in VS Code](https://user-images.githubusercontent.com/16547949/53640015-ee73b780-3bf8-11e9-8c90-be9022b9555a.png) 61 | 62 | {% else %} 63 | 64 | 1. Navigate to the [Code tab]({{ thePayload.repository.html_url }}) 65 | 2. Click **Branch: main** in the drop-down 66 | 3. In the field, enter a name for your branch, like `my-slide` 67 | 4. Click **Create branch: ** or press the Enter key to create your branch 68 | 69 | {% endif %} 70 |
71 |

I'll respond when I detect a new branch has been created in this repository.

72 | -------------------------------------------------------------------------------- /responses/03_head-to-branch.md: -------------------------------------------------------------------------------- 1 | ## Consider this issue finished! :white_check_mark: 2 | 3 |
4 |

Head over to the next issue now!

5 | -------------------------------------------------------------------------------- /responses/03_your-first-contribution.md: -------------------------------------------------------------------------------- 1 | ### Introduction to GitHub flow 2 | 3 | Now that you're familiar with issues, let's use this issue to track your path to your first contribution. 4 | 5 | People use different workflows to contribute to software projects, but the simplest and most effective way to contribute on GitHub is the GitHub flow. 6 | 7 | :tv: [Video: Understanding the GitHub flow](https://www.youtube.com/watch?v=PBI2Rz-ZOxU) 8 | 9 |
10 |

Read below for next steps

11 | -------------------------------------------------------------------------------- /responses/04_commit-something.md: -------------------------------------------------------------------------------- 1 | ## Step 5: Commit a file 2 | 3 | :tada: You created a branch! 4 | 5 | Creating a branch allows you to make modifications to your project without changing the deployed `main` branch. Now that you have a branch, it’s time to create a file and make your first commit! 6 | 7 |
Commits 101 8 | 9 | ## Commits 101 10 | 11 | When you’re finished creating or making changes to a file on GitHub, scroll to the bottom of the page. Then find the "Commit new file" section. 12 | 13 | In the first field, type a commit message. The commit message should briefly tell contributors about the changes you are introducing to the file. 14 | 15 | ### Rules to live by for commit messages: 16 | 17 | - Don’t end your commit message with a period. 18 | - Keep your commit messages to 50 characters or less. Add extra detail in the extended description window if necessary. This is located just below the subject line. 19 | - Use active voice. For example, "add" instead of "added" and "merge" instead of "merged". 20 | - Think of your commit as expressing intent to introduce a change. 21 | 22 |
23 |
24 | 25 | ### :keyboard: Activity: Your first commit 26 | 27 | The following steps will guide you through the process of committing a change on GitHub. 28 | 29 | {% if preferences.gitTool == 'cli' %} 30 | 1. Check out to your branch: 31 | ```shell 32 | git checkout {{ thePayload.ref }} 33 | ``` 34 | 1. Create a new file named `_posts/0000-01-02-{{ user.username }}.md`. 35 | 1. Add the following content to your file: 36 | ```yaml 37 | --- 38 | layout: slide 39 | title: "Welcome to our second slide!" 40 | --- 41 | Your text 42 | Use the left arrow to go back! 43 | ``` 44 | 1. Stage your new file: 45 | ```shell 46 | git add _posts/0000-01-02-{{ user.username }}.md 47 | ``` 48 | 1. After adding the text, commit the change while providing a commit message. For guidelines on commit messages, check out the **Commits 101** drop-down, just above these instructions: 49 | ```shell 50 | git commit -m "" 51 | ``` 52 | 1. Push your new commit to GitHub: 53 | ```shell 54 | git push 55 | ``` 56 | 57 | {% elsif preferences.gitTool == 'vscode' %} 58 | 1. In the `_posts` folder, create a new file named `0000-01-02-{{ user.username }}.md`. The full path to your file will be: `_posts/0000-01-02-{{ user.username }}.md`. 59 | 1. Add the following content to your file and save it: 60 | ```yaml 61 | --- 62 | layout: slide 63 | title: "Welcome to our second slide!" 64 | --- 65 | Your text 66 | Use the left arrow to go back! 67 | ``` 68 | 1. To stage your new file: go to the Source Control view and click the **+** button next to the file. You can also follow along with [VS Code's official documentation](https://code.visualstudio.com/docs/editor/versioncontrol#_commit). 69 | ![a screenshot of the staging button in the source control view](https://user-images.githubusercontent.com/16547949/53641057-d5b8d100-3bfb-11e9-9b69-53b0661cd5cd.png) 70 | 1. Commit the change by typing a commit message in the text field and pressing Ctrl+Enter on Windows or Command ⌘+Enter on macOS. 71 | ![a screenshot of the commit message on VS Code](https://user-images.githubusercontent.com/16547949/53641276-698a9d00-3bfc-11e9-9b3d-01680fd01d7c.png) 72 | 1. Click on the ellipsis (...) and select **Push**. 73 | 74 | {% else %} 75 | 1. Create a new file on this branch, in a `_posts` folder called `0000-01-02-{{ user.username }}.md`. You can do so using [this shortcut]({{ thePayload.repository.html_url }}/new/{{ thePayload.ref }}?filename=_posts/0000-01-02-{{ user.username }}.md) or manually as follows: 76 | - Return to the "Code" tab 77 | - In the branch drop-down, select "{{ thePayload.ref }}" 78 | - Click **Create new file** 79 | - In the "file name" field, type `_posts/0000-01-02-{{ user.username }}.md`. Entering the `/` in the filename will automatically place your file in the `_posts` directory. 80 | 1. When you’re done naming the file, add the following content to your file: 81 | ```yaml 82 | --- 83 | layout: slide 84 | title: "Welcome to our second slide!" 85 | --- 86 | Your text 87 | Use the left arrow to go back! 88 | ``` 89 | 1. After adding the text, you can commit the change by entering a commit message in the text-entry field below the file edit view. For guidelines on commit messages, check out the **Commits 101** drop-down, just above these instructions 90 | 1. When you’ve entered a commit message, click **Commit new file** 91 | {% endif %} 92 |
93 |

I'll respond when I detect a new commit on this branch.

94 | -------------------------------------------------------------------------------- /responses/05_open-a-pr.md: -------------------------------------------------------------------------------- 1 | ## Step 6: Open a pull request 2 | 3 | Nice work making that commit :sparkles: 4 | 5 | Now that you’ve created a commit, it’s time to share your proposed change through a pull request! Where issues encourage discussion with other contributors and collaborators on a project, pull requests help you share your changes, receive feedback on them, and iterate on them until they’re perfect! 6 | 7 |
What is a pull request? 8 | 9 | ## Pull requests 10 | 11 | Let’s think back to the GitHub flow again. You have created a branch, added a file, and committed the file to your branch. Now it’s time to collaborate on your file with other students taking this class. This collaboration happens in a pull request. Check out this video to learn more: 12 | 13 | :tv: [Video: Introduction to pull requests](https://youtu.be/kJr-PIfLDl4) 14 |
15 |
16 | 17 | This pull request is going to keep the changes you just made on your branch and propose applying them to the `main` branch. 18 | 19 | ### :keyboard: Activity: Create a pull request 20 | 21 | 1. Open a pull request using [this shortcut]({{ url }}) or manually as follows: 22 | - From the "Pull requests" tab, click **New pull request** 23 | - In the "base:" drop-down menu, make sure the "main" branch is selected 24 | - In the "compare:" drop-down menu, select "{{ branch | remove: 'refs/heads/' }}" 25 | 1. When you’ve selected your branch, enter a title for your pull request. For example `Add {{ user.username }}'s file` 26 | 1. The next field helps you provide a description of the changes you made. Feel free to add a description of what you’ve accomplished so far. As a reminder, you have: created a branch, created a file and made a commit, and opened a pull request 27 | 1. Click **Create pull request** 28 | 29 |
30 |

I'll respond in your new pull request.

31 | -------------------------------------------------------------------------------- /responses/06_fix-base.md: -------------------------------------------------------------------------------- 1 | Your base branch should be named `main`. Let's open a new pull request to fix this. 2 | 3 | ### :keyboard: Activity: Adjust PR direction 4 | 5 | 1. Click on the **Edit** button located to the right of your pull request's title 6 | 1. Below the title's comment box, in the "base:" drop-down menu, make sure the “main” branch is selected 7 | 1. A pop-up window will appear asking if you want to change the "base". Click the green **Change base** button 8 | 9 | If you would like assistance troubleshooting the issue you are encountering, create a post on the [GitHub Community]({{ communityBoard }}) board. You might also want to search for your issue to see if other people have resolved it in the past. 10 | 11 |
12 |

I'll respond when I detect this pull request's base has been edited.

13 | -------------------------------------------------------------------------------- /responses/06_fix-body.md: -------------------------------------------------------------------------------- 1 | Good pull requests have a body description that tells other contributors about the change you're suggesting, so they understand the context. 2 | 3 | Let's edit this pull request to add a body description. 4 | 5 | ## :keyboard: Activity: Fixing your pull request 6 | 7 | 1. The first comment on your pull request will have the default text of **No description provided**. Click on the **...** icon located at the top right corner of the comment box, then click on **Edit** to make an edit 8 | 1. Add a description of the changes you've made in the comment box. Feel free to add a description of what you’ve accomplished so far. As a reminder, you have: created a branch, created a file and made a commit, and opened a pull request 9 | 1. Click the green **Update comment** button at the bottom right of the comment box when done 10 | 11 | If you would like assistance troubleshooting the issue you are encountering, create a post on the [GitHub Community]({{ communityBoard }}) board. You might also want to search for your issue to see if other people have resolved it in the past. 12 | 13 |
14 |

I'll respond when I detect this pull request's body has been edited.

15 | -------------------------------------------------------------------------------- /responses/06_fix-filename.md: -------------------------------------------------------------------------------- 1 | I was expecting your file to be named **{{ expected }}**. 2 | 3 | Let's edit this pull request to fix both of these issues. 4 | 5 | ## :keyboard: Activity: Fixing the file name in your pull request 6 | 7 | {% if preferences.gitTool == 'cli' %} 8 | 1. Check out to your branch: 9 | ```shell 10 | git checkout {{ branch }} 11 | ``` 12 | 1. Type `ls` to see a listing of your root directory. 13 | 1. Confirm that you've got a folder titled `_posts`. 14 | 1. Step into the folder with `cd _posts`. 15 | 1. Type `ls` to see a listing of your `_posts` folder. 16 | 1. Ensure you've got a file named `{{ expected }}`. 17 | 1. If you find you have to make any changes, then stage, commit, and push those changes: 18 | ```shell 19 | git add . 20 | git commit -m "" 21 | git push 22 | ``` 23 | {% else %} 24 | 1. Click the [Files Changed tab]({{ url }}) in this pull request. 25 | 1. Verify that the only file edited is named `{{ expected }}`. 26 | 1. If the file is improperly named, or not in a proper location, use the edit function to correct it. 27 | 1. Above the contents of the file, select all text in the field that contains the filename and delete it. 28 | 1. Continue pressing your backspace key to also delete any directory names that exist. 29 | 1. Type the proper filename: 30 | ```shell 31 | {{ expected }} 32 | ``` 33 | 1. Scroll to the bottom and enter a commit message and commit in the **Commit Changes** section. 34 | 35 | ![gif of changing file name in UI](https://user-images.githubusercontent.com/9906718/112817649-f4ac1a80-9082-11eb-972f-4a6609857b20.gif) 36 | {% endif %} 37 | 38 | **Note**: You can find directions on how to move files while editing in our [documentation](https://docs.github.com/en/github/managing-files-in-a-repository/moving-a-file-to-a-new-location). 39 | 40 | If you would like assistance troubleshooting the issue you are encountering, create a post on the [GitHub Community]({{ communityBoard }}) board. You might also want to search for your issue to see if other people have resolved it in the past. 41 | 42 |
43 |

I'll respond below when I detect a commit on this branch.

44 | -------------------------------------------------------------------------------- /responses/06_request-changes.md: -------------------------------------------------------------------------------- 1 | ## Step 7: Respond to a review 2 | 3 | Your pull request is looking great! 4 | 5 | Let’s add some content to your file. Replace line 5 of your file with a quotation or meme and witty caption. Remember: [Markdown](https://guides.github.com/features/mastering-markdown/) is supported. 6 | 7 | ### :keyboard: Activity: Change your file 8 | 9 | {% if preferences.gitTool == 'cli' %} 10 | 1. Check out to your branch: 11 | ```shell 12 | git checkout {{ branch }} 13 | ``` 14 | 1. Open the file `_posts/0000-01-02-{{ user.username }}.md`. 15 | 1. Replace line 5 of the file with something new. 16 | 1. Stage your new changes: 17 | ```shell 18 | git add _posts/0000-01-02-{{ user.username }}.md 19 | ``` 20 | 1. Commit your changes: 21 | ```shell 22 | git commit -m "" 23 | ``` 24 | 1. Push your edits to GitHub: 25 | ```shell 26 | git push 27 | ``` 28 | 29 | {% elsif preferences.gitTool == 'vscode' %} 30 | 1. Open the file `_posts/0000-01-02-{{ user.username }}.md`. 31 | 1. Replace line 5 of the file with something new. 32 | 1. Stage your new changes. As a reminder, you can do this in the Source Control view, click the **+** symbol next to the file. 33 | 1. Commit your changes. You can do this in the Source Control view, enter a commit message in the text field and press Ctrl+Enter on Windows or Command ⌘+Enter on macOS. 34 | 1. Push your edits to GitHub. In the Source Control view, click on the ellipsis (...), and select **Push**. 35 | 36 | {% else %} 37 | 1. Click the [Files Changed tab]({{ url }}) in this pull request 38 | 1. Edit your newly added file 39 | 1. Replace line 5 with something new 40 | 1. Scroll to the bottom and click **Commit Changes** 41 | {% endif %} 42 | 43 | **Note** : Can't find the button to edit the file? It may look like a pencil, or it may look like three dots. 44 | 45 |
46 |

I'll respond when I detect a commit on this branch.

47 | -------------------------------------------------------------------------------- /responses/07_pr-succeeds.md: -------------------------------------------------------------------------------- 1 | ## Step 8: Merge your pull request 2 | 3 | Nicely done @{{ user.username }}! :sparkles: 4 | 5 | You successfully created a pull request, and it has passed all of the tests. You can now merge your pull request. 6 | 7 | ### :keyboard: Activity: Merge the pull request 8 | 9 | {% if preferences.gitTool == 'cli' %} 10 | 1. Check out to the `main` branch: 11 | ```shell 12 | git checkout main 13 | ``` 14 | 2. Merge your branch: 15 | ```shell 16 | git merge {{ branch }} 17 | ``` 18 | 3. Push the merged history to GitHub: 19 | ```shell 20 | git push 21 | ``` 22 | 4. Delete your the branch locally: 23 | ```shell 24 | git branch -d {{ branch }} 25 | ``` 26 | {% else %} 27 | 1. Click **Merge pull request** 28 | 1. Click **Confirm merge** 29 | {% endif %} 30 | 1. Once your branch has been merged, you don't need it anymore. Click **Delete branch**. 31 | 32 |
33 |

I'll respond when this pull request is merged.

34 | -------------------------------------------------------------------------------- /responses/08_reminder-delete.md: -------------------------------------------------------------------------------- 1 | ## Nice work 2 | 3 | ![celebrate](https://octodex.github.com/images/collabocats.jpg) 4 | 5 | Congratulations @{{ user.username }}, you've completed this course! 6 | 7 | ## What went well 8 | 9 | Now, you have your slide deck deployed [here]({{ store.pagesUrl }}) and you've gone through the GitHub Flow. 10 | 11 | Before I say good-bye, here's a recap of all the tasks you've accomplished in your repository: 12 | 13 | - You learned about issues, pull requests, and the structure of a GitHub repository 14 | - You learned about branching 15 | - You created a commit 16 | - You viewed and responded to pull request reviews 17 | - You edited an existing file 18 | - You enabled GitHub Pages 19 | - You made your first contribution! :tada: 20 | 21 | ## Give us feedback 22 | 23 | We'd love to hear what you thought of this course. Please share your feedback in [this brief survey](https://www.surveymonkey.com/r/intro-to-github-1). 24 | 25 | ## What's next? 26 | 27 | We hope this course helped you feel more comfortable using GitHub. Remember: You’re always welcome to repeat course topics if you’d like additional practice. If you’re ready to build on your new skills, here are some ideas. 28 | 29 | ### Contribute to a project 30 | 31 | To find projects to contribute to through trending topics and curated collections, check out [GitHub Explore](https://github.com/explore). 32 | 33 | ### Keep learning 34 | 35 | Here are some suggestions for future courses you can take: 36 | - [GitHub Pages]({{ host }}/{{ course.Owner.login }}/github-pages): Continue learning about GitHub Pages, which we touched on in this course. 37 | - [Communicating using Markdown]({{ host }}/{{ course.Owner.login }}/communicating-using-markdown): We used a little Markdown in this course, but if you want to learn all about this :sparkles: syntax, take the course! 38 | 39 | [What will you learn next]({{ host }}/courses)? 40 | -------------------------------------------------------------------------------- /responses/08_reopen.md: -------------------------------------------------------------------------------- 1 | ### :keyboard: Activity: Reopen pull request 2 | 3 | Oooops! It looks like you might have accidentally closed your pull request. 4 | 5 | 1. Click **Reopen pull request**. If this button is inactive, you will need to click **Restore branch** first 6 | 1. Merge the pull request. 7 | 8 |
9 |

I'll respond when this pull request is merged.

10 | -------------------------------------------------------------------------------- /responses/es/00_assign-yourself.md: -------------------------------------------------------------------------------- 1 | ## Paso 1: Asígnate 2 | 3 | Las propuestas (_issues_) que no han sido asignadas no tienen a una persona que se encargue de ellas. Cuando te asignan una propuesta o solicitud de extracción, esto dice a visitantes y colaboradores de tu repositorio que tú vas a estar facilitando la conversación o la tarea. 4 | 5 | ### :keyboard: Actividad 6 | 7 | 1. En la parte derecha de tu pantalla, bajo la sección de "Assignees", haz clic en el icono de engranaje y selecciónate. También puedes hacer clic en "assign yourself". 8 | 9 | Para una versión impresa de los pasos en este curso, revisa la [Quick Reference Guide]({{ host }}/public/{{ course.slug }}.pdf). 10 | 11 |
12 |

Responderé cuando haya detectado que te has asignado esta propuesta.

13 | 14 | > _¡A veces respondo muy rápido, antes de que la página se actualice! Si ya realizaste la acción y no me ves responder, espera unos segundos y actualiza la página para mostrar los siguientes pasos._ 15 | 16 | -------------------------------------------------------------------------------- /responses/es/00_introduction.md: -------------------------------------------------------------------------------- 1 | # :wave: Bienvenido a "Introducción a GitHub" de GitHub Learning Lab 2 | 3 | Para empezar, te guiaré a través de unos primeros pasos que son importantes para programar y colaborar en GitHub. 4 | 5 | :point_down: _Esta flecha indica que puedes expandir la ventana! Haz clic en ellas durante el curso para más información._ 6 |
¿Qué es GitHub? 7 |
8 | 9 | ## ¿Qué es GitHub? 10 | 11 | ¡Me alegra que lo hayas preguntado! Muchas personas usan GitHub porque quieren contribuir a proyectos de código abierto [:book:](https://help.github.com/articles/github-glossary/#open-source), o porque son invitados por compañeros de trabajo o de clase que usan GitHub en sus proyectos. ¿Por qué la gente usa GitHub en sus proyectos? 12 | 13 | **En esencia, GitHub es una plataforma de colaboración.** 14 | 15 | Desde software hasta documentos legales, puedes contar con GitHub para ayudarte a hacer tu mejor trabajo con las herramientas de colaboración y seguridad que tu equipo necesita. Con GitHub, puedes mantener proyectos completamente privados, invitar al mundo a colaborar y optimizar cada paso de tu proyecto. 16 | 17 | **GitHub también es una poderosa herramienta de versión de control.** 18 | 19 | GitHub usa Git [:book:](https://help.github.com/articles/github-glossary/#git), el software de control de versión más popular para rastrear cada contribución y colaborador [:book:](https://help.github.com/articles/github-glossary/#contributor) de tu proyecto--de esta manera sabrás exactamente de dónde vino cada línea de código de tu proyecto. 20 | 21 | **GitHub ayuda a las personas a hacer mucho más.** 22 | 23 | La gente usa GitHub para construir varias de las tecnologías más avanzadas del mundo. Ya sea que estes visualizando datos o construyendo un nuevo juego, hay una comunidad entera y un set de herramientas en GitHub que te puedan llevar al siguiente nivel. Este curso empieza con lo básico pero ¡profundizaremos el resto después! 24 | 25 | :tv: [Video: ¿Qué es GitHub?](https://www.youtube.com/watch?v=w3jLJU7DT5E) 26 |
27 |

28 | 29 |
Explorando un repositorio de GitHub 30 |
31 | 32 | ## Explorando un repositorio de GitHub 33 | 34 | :tv: [Video: Explorando un repositorio](https://www.youtube.com/watch?v=R8OAwrcMlRw) 35 | 36 | ### Más características 37 | 38 | El video cubre algunas de las características usadas con mayor frecuencia. Aquí hay otras cosas que puedes encontrar en los repositorios de GitHub: 39 | 40 | - Tableros para el proyecto: Crear un tablero estilo Kanban para seguir tus tareas dentro de GitHub 41 | - Wiki: Crea y guarda documentación relevante acerca de tu proyecto. 42 | - Estadísticas: Ve un menú desplegable que contiene enlaces a herramientas de análisis para tu repositorio, que incluyen: 43 | - Pulso: Encuentra información sobre el trabajo que ha sido completado y el trabajo que está en progreso en este panel del proyecto. 44 | - Gráficas: Las gráficas proporcionan una vista más granular de la actividad del repositorio, incluyendo quién contribuyó al repositorio, quién lo bifurcó y cuándo completaron el trabajo. 45 | 46 | ### Archivos especiales 47 | 48 | En el video aprendiste sobre un archivo especial llamado README.md. Aquí hay una lista de algunos otros archivos especiales que puedes añadir a tus repositorios: 49 | 50 | - CONTRIBUTING.md: El archivo `CONTRIBUTING.md` es usado para describir el proceso para contribuir al repositorio. Un link al archivo `CONTRIBUTING.md` es mostrado cada vez que alguien crea una nueva propuesta o una solicitud de extracción. 51 | - ISSUE_TEMPLATE.md: El archivo `ISSUE_TEMPLATE.md` lo puedes usar para rellenar el cuerpo de una propuesta. Por ejemplo, si siempre necesitas el mismo tipo de información para reportar errores puedes incluirlo en la plantilla de tu propuesta y cada nueva propuesta será abierta con el texto que has recomendado para empezar. 52 | 53 |
54 |
55 | 56 | ### Usando las propuestas (o _issues_) 57 | Esto es una propuesta (o _issue_) [:book:](https://help.github.com/articles/github-glossary/#issue): un lugar en el que puedes tener conversaciones sobre los errores en tu código, revisiones de código y casi cualquier otra cosas que te puedas imaginar. 58 | 59 | Los títulos de tus propuestas son como la línea de asunto de un email. Avisan de un vistazo a tus colaboradores de qué trata tu propuesta. Por ejemplo, el título de esta propuesta es Getting Started with GitHub. 60 | 61 |
Usando GitHub Issues (propuestas) 62 | 63 | ## Usando propuestas de GitHub 64 | 65 | Las propuestas se usan para discutir ideas, mejoras, tareas y errores. Facilitan la colaboración al: 66 | 67 | - Proveer a todos (incluso miembros futuros) la historia completa en un solo lugar 68 | - Permitirte entrelazar tu propuesta con otras propuestas o una solicitud de extracción (o _pull request_) [:book:](https://help.github.com/articles/github-glossary/#pull-request) 69 | - Crear un registro único y completo de cómo y por qué tomaste ciertas decisiones 70 | - Permitirte atraer fácilmente a las personas y los equipos adecuados a una conversación con @mencion 71 | :tv: [Video: Usando propuestas](https://www.youtube.com/watch?v=Zhj46r5D0nQ) 72 | 73 |
74 |
75 | 76 |
Administrando notificaciones 77 |
78 | 79 | ## Administrando notificaciones 80 | 81 | :tv: [Video: Observando, notificaciones, estrellas y explorar](https://www.youtube.com/watch?v=ocQldxF7fMY) 82 | 83 | Una vez que hayas comentado en una propuesta o solicitud de extracción, empezarás a recibir notificaciones por email cada vez que haya actividad en tu hilo. 84 | 85 | ## Cómo silenciar o dejar de silenciar conversaciones en específico. 86 | 87 | 1. Ve a la propuesta o solicitud de extracción 88 | 2. Bajo _"Notifications"_, haz clic en el botón de **Unsubscribe** a la derecha para silenciar notificaciones o **Subscribe** para dejar de silenciarlas. 89 | 90 | Verás una descripción corta que explica tu estado actual de notificaciones. 91 | 92 | ### Cómo personalizar notificaciones en Settings 93 | 94 | 1. Haz clic en el icono de tu perfil 95 | 2. Haz clic en **Settings** 96 | 3. Haz clic en **Notifications** desde el menú a tu izquierda y [ajusta tus preferencias de notificaciones](https://help.github.com/articles/managing-notification-delivery-methods/) 97 | 98 | ### Opciones de notificación de un repositorio 99 | 100 | * **Watch**: Recibirás una notificación cuando una nueva propuesta, solicitud de extracción o comentario ha sido publicado y también cuando una propuesta ha sido cerrado o una solicitud de extracción ha sido fusionada. 101 | * **Not watching**: No vas a recibir notificaciones al menos que te hayan mencionado usando @ 102 | * **Ignore**: No vas a recibir ningún tipo de notificación sobre este respoitorio 103 | 104 | ## Cómo revisar las notificaciones de los repositorios que estás observando 105 | 106 | 1. Haz clic en tu icono de perfil 107 | 2. Haz clic en **Settings** 108 | 3. Haz clic en **Notification** desde el menú a tu izquierda 109 | 4. Haz clic en el link de [repositorios que estás observando](https://github.com/watching) 110 | 5. Selecciona la pestaña **Watching** 111 | 6. Haz clic en el botón de **Unwatch** para inhabilitar las notificaciones o en **Watch** para habilitarlas. 112 | 113 |
114 |
115 | 116 |
117 |

Sigue leyendo a continuación para encontrar tu primera tarea

118 | -------------------------------------------------------------------------------- /responses/es/01_turn-on-gh-pages.md: -------------------------------------------------------------------------------- 1 | ## Paso 2: Activa GitHub Pages 2 | 3 | :tada: ¡Ahora eres quien supervisa esta propuesta! Ahora que te has autodesignado, las personas que vean tu propuesta sabrán que su participación es bienvenida, pero tú estás al cargo de llevar esta propuesta hasta el punto final :sunglasses:. 4 | 5 | ### Usemos GitHub Pages 6 | 7 | ¡Ahora, a lo que venimos! GitHub Pages te permite servir un sitio estático basado en un repositorio. Hemos llenado este repositorio con contenido, pero el sitio aún no es visible. Cambiemos eso. 8 | 9 | ### :keyboard: Actividad: Habilita GitHub Pages 10 | 11 | 1. Haz clic en la pestaña [**Settings**]({{ repoUrl }}/settings) de este repositorio 12 | 1. Navega a la sección de GitHub Pages 13 | 1. En la lista llamada "Source" selecciona **main branch** 14 | 15 | > Nota: Aunque puedes ver una opción para escoger un tema, no apliques ningún tema en este momento. Hemos protegido el código para que no puedas hacer cambios involuntarios. Tendrás oportunidad de usar un tema cuando terminemos el curso. 16 | 17 |
18 |

Responderé en esta propuesta cuando detecte que GitHub Pages ha implementado tu página.

19 | 20 | > Activar GitHub Pages crea una implementación de tu repositorio. Me podré tomar hasta un minuto para responder mientras espero que la implementación termine. 21 | -------------------------------------------------------------------------------- /responses/es/02_close-issue.md: -------------------------------------------------------------------------------- 1 | ## Paso 3: Cierra una propuesta 2 | 3 | ¡Haz activado GitHub Pages! 4 | 5 | Ahora tu sitio es visible para el público. Compruébalo en {{ store.pagesUrl }}. 6 | 7 | Ahora que ya completaste las tareas en esta propuesta, ¡es hora de cerrarla! Cerrar una propuesta les dice al resto de colaboradores que esta conversación o tarea en particular ha sido completada. 8 | 9 | ### :keyboard: Actividad 10 | 11 | 1. Haz clic en el botón de **Close issue** aquí abajo 12 | 13 |
14 |

Responderé cuando hayas cerrado esta propuesta.

-------------------------------------------------------------------------------- /responses/es/03_create-a-branch.md: -------------------------------------------------------------------------------- 1 | ## Paso 4: Crea una rama 2 | 3 | Completemos el primer paso del flujo de GitHub: crear una rama (o _branch_) [:book:](https://help.github.com/articles/github-glossary/#branch). 4 | 5 |
Creando una rama 6 | 7 | ## Creando una rama 8 | 9 | :tv: [Video: Ramas](https://www.youtube.com/watch?v=xgQmu81G1yY) 10 | 11 | Acabas de aprender cómo crear una rama—el primer paso del flujo de GitHub. 12 | 13 | Las ramas son una parte importante del flujo de GitHub porque nos permite separar nuestro trabajo de la rama principal o `main`. En otras palabras, el trabajo de todos está a salvo mientras aportas contribuciones. 14 | 15 | ### Tips para usar ramas 16 | Un solo proyecto puede tener cientos de ramas, cada una sugiriendo un nuevo cambio a la rama principal o `main`. 17 | 18 | La mejor manera de mantener tus ramas organizadas en un equipo es mantenerlas concisas y efímeras. En otras palabras, una sola rama debería representar solamente una nueva característica o una corrección de errores. Esto permite que haya menos confusión entre colaboradores cuando las ramas solamente están activas por unos días antes de que sean fusionadas [:book:](https://help.github.com/articles/github-glossary/#merge) con la rama principal o `main`. 19 | 20 |
21 |
22 | 23 | ### :keyboard: Actividad: Tu primera rama 24 | 25 | {% if preferences.gitTool == 'cli' %} 26 | 1. Abre tu interfaz de línea de comandos (CLI) preferida, a la cual llamaremos shell de aquí en adelante. 27 | 1. Clona este repositorio: 28 | ```shell 29 | git clone {{ thePayload.repository.clone_url }} 30 | ``` 31 | 1. Navega a este repositorio en tu shell: 32 | ```shell 33 | cd {{ thePayload.repository.name }} 34 | ``` 35 | 1. Crea una rama, usa el nombre que quieras. Siéntete libre de usar el nombre sugerido a continuación. 36 | ```shell 37 | git branch my-slide 38 | ``` 39 | 1. Sube la rama a GitHub: 40 | ``` 41 | git push --set-upstream origin 42 | ``` 43 | 44 | {% elsif preferences.gitTool == 'vscode' %} 45 | 1. Descarga y abre [Visual Studio Code](https://code.visualstudio.com/Download) (referido como VS Code) si aún no lo tienes. 46 | 1. En VS Code, abre la Paleta de Comandos (o _Command Palette_) usando Ctrl+Mayús+P en Windows, o Command ⌘+Mayús+P en macOS. También puedes seguir [la documentación oficial de VS Code](https://code.visualstudio.com/docs/editor/versioncontrol#_cloning-a-repository) sobre clonar repositorios. 47 | 1. Escribe `git clone`y presiona Enter 48 | ![una captura de pantalla de VS Code con la Paleta de Comandos abierta](https://user-images.githubusercontent.com/16547949/53639288-bcf9ec80-3bf6-11e9-9d18-d97167168248.png) 49 | 1. Pega la URL del repositorio en la nueva ventana y presiona Enter: 50 | ```shell 51 | {{ thePayload.repository.clone_url }} 52 | ``` 53 | 1. Selecciona la ubicación en el que quieres guardar el repositorio y haz clic en **Choose folder**. Después, abre la ubicación que seleccionaste. 54 | 1. El directorio del repositiorio debería estar ahora abierto en tu proyecto de VS Code. Haz clic en `main` en la parte inferior de la ventana de VS Code. Esto abrirá la Paleta de Comandos con todos los comandos relacionados a ramas de Git. 55 | ![una captura de pantalla de las ramas de Git en VS Code](https://user-images.githubusercontent.com/16547949/53639606-adc76e80-3bf7-11e9-98ac-bd41ae2b40db.png) 56 | 1. Haz clic en **Create new branch** e ingresa cualquier nombre que le quieras dar a tu rama, como `mi-rama`. A continuación, presiona Enter. 57 | 1. Cuando te hagan seleccionar la rama que servirá de referencia para tu nueva rama, selecciona `main`. 58 | 1. Ve a la vista de Source Control, haz clic en los punto suspensivos (...) y selecciona **Push**. En la caja de diálogo preguntándote si quieres publicar tu rama, confirma que sí. 59 | ![una captura de pantalla de la vista de Source Control en VS Code](https://user-images.githubusercontent.com/16547949/53640015-ee73b780-3bf8-11e9-8c90-be9022b9555a.png) 60 | 61 | {% else %} 62 | 63 | 1. Navega a la [pestaña titulada Code]({{ thePayload.repository.html_url }}) 64 | 2. Haz clic en **Branch: main** en el desplegable 65 | 3. En el campo, ingresa un nombre para tu rama, como `mi-rama` 66 | 4. Haz clic en **Create branch: ** o presiona la tecla "Enter" para crear tu rama 67 | 68 | {% endif %} 69 |
70 |

Responderé cuando haya detectado que una nueva rama ha sido creada en este repositorio.

-------------------------------------------------------------------------------- /responses/es/03_head-to-branch.md: -------------------------------------------------------------------------------- 1 | ## ¡Considera esta propuesta terminada! :white_check_mark: 2 | 3 |
4 |

Navega a la siguiente propuesta ahora!

5 | -------------------------------------------------------------------------------- /responses/es/03_your-first-contribution.md: -------------------------------------------------------------------------------- 1 | ### Introducción al flujo de GitHub 2 | 3 | Ahora que te has familiarizado con las propuestas (o _issues), usemos esta propuesta para seguir el camino a tu primera contribución. 4 | 5 | Diferentes personas usan diferentes flujos de trabajo para contribuir a proyectos de software, pero la forma más simple y efectiva de contribuir en GitHub es con el flujo de GitHub. 6 | 7 | :tv: [Video: Entendiendo el flujo de GitHub](https://www.youtube.com/watch?v=PBI2Rz-ZOxU) 8 | 9 |
10 |

Sigue leyendo para ver los siguientes pasos

11 | -------------------------------------------------------------------------------- /responses/es/04_commit-something.md: -------------------------------------------------------------------------------- 1 | ## Paso 5: Confirma un archivo 2 | 3 | :tada: ¡Haz creado una rama! 4 | 5 | Crear una rama te permite hacer modificaciones a tu proyecto sin tener que cambiar la rama `main`. Ahora que tienes una rama, es hora de crear un archivo y ¡hacer tu primera confirmación de cambios! 6 | 7 |
Commits 101 8 | 9 | ## Commits 101 10 | 11 | Cuando hayas terminado de crear o hacer cambios a tu archivo en GitHub, desplázate hasta la parte inferior de la página. Después, encuentra la sección titulada "Commit new file". 12 | 13 | En el primer campo, escribe un mensaje de confirmación (o _commit message_). El mensaje debe informar a tus colaboradores de forma breve sobre los cambios que has introducido al archivo. 14 | 15 | ### Recomendaciones para los mensajes de confirmación: 16 | 17 | - No termines tu mensaje con un punto. 18 | - Mantén tu mensaje con 50 o menos caracteres. Si es necesario añade detalles extra en la ventana de descripción extendida. Esta se encuentra justo debajo de la línea de asunto. 19 | - Usa la voz activa. Por ejemplo, "Añade la funcionalidad xx" en vez de "Añadida la funcionalidad xx" y "Combina los cambios" en lugar de "Combinados los cambios". 20 | - Piensa en tu confirmación de cambios como una manera de expresar que quieres introducir una modificación. 21 | 22 |
23 |
24 | 25 | ### :keyboard: Actividad: Tu primera confirmación de cambios (o _commit_) 26 | 27 | Los siguientes pasos te guiarán a través del proceso de hacer una confirmación de cambios (_commit_) para una modificación en GitHub. 28 | 29 | {% if preferences.gitTool == 'cli' %} 30 | 1. Selecciona tu rama: 31 | ```shell 32 | git checkout {{ thePayload.ref }} 33 | ``` 34 | 1. Crea un nuevo archivo llamado `_posts/0000-01-02-{{ user.username }}.md`. 35 | 1. Añade el siguiente contenido a tu archivo: 36 | ```yaml 37 | --- 38 | layout: slide 39 | title: "Bienvenidos a la segunda página!" 40 | --- 41 | Tu texto 42 | Utiliza la flecha hacia la izquierda para volver! 43 | ``` 44 | 1. Añade tu nuevo archivo: 45 | ```shell 46 | git add _posts/0000-01-02-{{ user.username }}.md 47 | ``` 48 | 1. Después de añadir tu texto, haz una confirmación de cambios y agrega un mensaje de confirmación, comprueba el desplegable **Commits 101**, justo arriba de estas instrucciones: 49 | ```shell 50 | git commit -m "" 51 | ``` 52 | 1. Manda tu nueva confirmación de cambios a GitHub: 53 | ```shell 54 | git push 55 | ``` 56 | 57 | {% elsif preferences.gitTool == 'vscode' %} 58 | 1. En el directorio `_posts` , crea un nuevo archivo llamado `0000-01-02-{{ user.username }}.md`. La ruta completa a tu archivo será: `_posts/0000-01-02-{{ user.username }}.md`. 59 | 1. Añade el siguiente contenido a tu archivo y guárdalo: 60 | ```yaml 61 | --- 62 | layout: slide 63 | title: "Bienvenidos a la segunda página!" 64 | --- 65 | Tu texto 66 | Utiliza la flecha hacia la izquierda para volver! 67 | ``` 68 | 1. Para añadir tu nuevo archivo ve a la vista de Source Control y haz clic en el botón **+** a lado del archivo. También puedes seguir este paso con la [documentación oficial de VS Code](https://code.visualstudio.com/docs/editor/versioncontrol#_commit). 69 | ![una captura del botón de staging en la vista Source Control](https://user-images.githubusercontent.com/16547949/53641057-d5b8d100-3bfb-11e9-9b69-53b0661cd5cd.png) 70 | 1. Haz una confirmación de cambios escribiendo un mensaje de confirmación en el campo de texto y después presionandoCtrl+Enter en Windows o Comando ⌘+Enter en macOS. 71 | ![una captura del mensaje de confirmación de cambios VS Code](https://user-images.githubusercontent.com/16547949/53641276-698a9d00-3bfc-11e9-9b3d-01680fd01d7c.png) 72 | 1. Haz clic en los puntos suspensivos (...) y selecciona **Push**. 73 | 74 | {% else %} 75 | 1. Crea un nuevo archivo en esta rama, en un directorio llamado `_posts` y llámalo `0000-01-02-{{ user.username }}.md`. Lo puedes hacer usando [este atajo]({{ thePayload.repository.html_url }}/new/{{ thePayload.ref }}?filename=_posts/0000-01-02-{{ user.username }}.md) o manualmente de la siguiente manera: 76 | - Regresa a la pestaña "Code" 77 | - En la lista desplegable de ramas, selecciona "{{ thePayload.ref }}" 78 | - Haz clic en **Create new file** 79 | - En el campo "file name", escribe `_posts/0000-01-02-{{ user.username }}.md`. Escribir `/` en el nombre del archivo va a poner tu archivo automáticamente en el directorio `_posts`. 80 | 1. Cuando hayas acabado de nombrar tu archivo, añade el siguiente contenido a tu archivo: 81 | ```yaml 82 | --- 83 | layout: slide 84 | title: "Bienvenidos a la segunda página!" 85 | --- 86 | Tu texto 87 | Utiliza la flecha hacia la izquierda para volver! 88 | ``` 89 | 1. Después de añadir tu texto, puedes hacer una confirmación de cambios al agregar un mensaje de confirmación en el campo text-entry abajo de la vista de edición de archivo. Para más información sobre mensajes de confirmación, comprueba el desplegable **Commits 101** , justo arriba de estas instrucciones: 90 | 1. Cuando hayas escrito tu mensaje de confirmación , haz clic en **Commit new file** 91 | {% endif %} 92 |
93 |

Responderé cuando haya detectado una nueva confirmación de cambio en esta rama.

94 | -------------------------------------------------------------------------------- /responses/es/05_open-a-pr.md: -------------------------------------------------------------------------------- 1 | ## Paso 6: Abre una solicitud de extracción 2 | 3 | Buen trabajo haciendo esa confirmación de cambios :sparkles: 4 | 5 | Ahora que has creado una confirmación de cambios, ¡es hora de compartir los cambios que propones por medio de una solicitud de extracción (o _pull request_)! Mientras que las propuestas (_issues_) fomentan la discusión con otros colaboradores de un proyecto, las solicitudes de extracción (_pull requests_) te ayudan a compartir tus cambios, recibir notas acerca de tus cambios y seguir trabajando en tus cambios ¡hasta que estén perfectos! 6 | 7 |
¿Qué es una solicitud de extracción? 8 | 9 | ## Solicitudes de extracción (o _pull requests_) 10 | 11 | Pensemos de nuevo en el flujo de GitHub. Has creado una rama, agregaste un archivo, e hiciste una confirmación de cambios de ese archivo en tu rama. Ahora es hora de colaborar en tu archivo con otros estudiantes que toman esta clase. Esta colaboración sucede dentro de una solicitud de extracción. Mira este video para aprender más: 12 | 13 | :tv: [Video: Introducción a las solicitudes de extracción](https://youtu.be/kJr-PIfLDl4) 14 |
15 |
16 | 17 | Esta solicitud de extracción mantendrá los cambios que hiciste dentro de tu rama y propondrá aplicarlos a la rama `main`. 18 | 19 | ### :keyboard: Actividad: Crea una solicitud de extracción 20 | 21 | 1. Abre una solicitud de extracción usando [este atajo]({{ url }}) o manualmente, así: 22 | - Desde la pestaña "Pull requests", haz clic en **New pull request** 23 | - En la lista desplegable llamada "base:", asegúrate que la rama "main" esté seleccionada 24 | - En la lista desplegable llamada "compare:", selecciona "{{ branch | remove: 'refs/heads/' }}" 25 | 1. Cuando hayas seleccionado tu rama, escribe un título para tu solicitud de extracción. Por ejemplo `Añadir el archivo de {{ user.username }}` 26 | 1. El siguiente campo te ayuda a agregar una descripción de los cambios que has hecho. Agrega una descripción de los cambios que has hecho hasta ahora. Recordatorio: has creado una rama, creado un archivo e iniciado la confirmación de cambios correspondiente y por último has abierto una solicitud de extracción 27 | 1. Haz clic en **Create pull request** 28 | 29 |
30 |

Responderé dentro de tu nueva solicitud de extracción.

31 | -------------------------------------------------------------------------------- /responses/es/06_fix-base.md: -------------------------------------------------------------------------------- 1 | Tu rama base debe llamarse `main` (principal). Vamos a abrir una nueva solicitud de extracción para arreglar esto. 2 | 3 | 1. Haz clic en el botón **Edit** que está localizado a la derecha del título de la solicitud de extracción. 4 | 1. Debajo de la cajita del título del comentario, en el menú desplegable "base:", asegúrate que la rama “main” esté seleccionada. 5 | 1. Una ventana pop-up va a aparecer para preguntar si quieres cambiar la "base". Haz clic en el botón verde titulado **Change base** 6 | 7 | Si necesitas ayuda buscando una solución a tu problema, crea una publicación en [GitHub Community]({{ communityBoard }}). También puedes buscar otras publicaciones acerca de tu problema si otras personas lo han resuelto previamente. 8 | 9 |
10 |

Responderé cuando detecte que la base de esta solicitud de extracción haya sido editada.

11 | -------------------------------------------------------------------------------- /responses/es/06_fix-body.md: -------------------------------------------------------------------------------- 1 | Las buenas solicitudes de extracción tienen una descripción que ofrece información al resto de colaboradores acerca del cambio que estás sugiriendo. Esto es para que comprendan mejor el contexto. 2 | 3 | Editemos esta solicitud de extracción para agregar una descripción. 4 | 5 | ## :keyboard: Actividad: Arreglando tu solicitud de extracción 6 | 7 | 1. El primer comentario que tu solicitud de extracción contendrá el texto predeterminado de **No description provided**. Haz clic en el icono **...** en la esquina superior derecha de la caja de comentario, y después haz clic en **Edit** para editar. 8 | 1. Agrega una descripción de los cambios que has hecho en la caja de comentario. Si deseas puedes agregar una descripción de tus logros hasta ahora. Recuerda: has creado una rama, creado un archivo y su confirmación de cambios correspondiente, y abriste una solicitud de extracción. 9 | 1. Cuando termines, haz clic al botón verde **Update comment** que se encuentra en el lado inferior derecho de la caja de comentario. 10 | 11 | Si necesitas ayuda buscando una solución a tu problema, crea una publicación en [GitHub Community]({{ communityBoard }}). También puedes buscar otras publicaciones acerca de tu problema si otras personas lo han resuelto previamente. 12 | 13 |
14 |

Responderé cuando detecte que el cuerpo de esta solicitud de extracción ha sido editado.

15 | -------------------------------------------------------------------------------- /responses/es/06_fix-filename.md: -------------------------------------------------------------------------------- 1 | Esperaba que tu archivo se llamara **{{ expected }}**. 2 | 3 | Editemos esta solicitud de extracción para arreglar ambos problemas. 4 | 5 | ## :keyboard: Actividad: Arregla tu solicitud de extracción 6 | 7 | {% if preferences.gitTool == 'cli' %} 8 | 1. Revisa tu rama: 9 | ```shell 10 | git checkout {{ branch }} 11 | ``` 12 | 1. Escribe `ls` para ver un listado del contenido de tu directorio de raíz. 13 | 1. Confirma que tienes un directorio llamado `_posts`. 14 | 1. Entra al directorio usando `cd _posts`. 15 | 1. Escribe `ls` para ver un listado de el contenido de tu directorio `_posts`. 16 | 1. Asegúrate que tienes un archivo llamado `{{ expected }}` 17 | 1. Si encuentras que tienes que hacer cambios, entonces añade, confirma tus cambios, y sube esos cambios: 18 | ```shell 19 | git add . 20 | git commit -m "" 21 | git push 22 | ``` 23 | {% else %} 24 | 1. Haz clic en la pestaña [Files Changed]({{ url }}) en esta solicitud de extracción 25 | 1. Verifica que sólo el archivo que editaste se llame `{{ expected }}`. 26 | 1. Si el archivo tiene el nombre incorrecto, o no esta en el lugar correcto, haz clic en el icono de lápiz que se encuentra al lado derecho de la pantalla para editar. 27 | 1. Arriba del contenido del archivo, selecciona "all text" en el campo que contiene el nombre del archivo y bórralo. 28 | 1. Continúa presionando la tecla backspace para también borrar cualquier directorio que exista. 29 | 1. Escribe el nombre de archivo apropiado: 30 | ```shell 31 | {{ expected }} 32 | ``` 33 | 1. Desplázate hasta el final de la página y escribe un mensaje de confirmación y haz una confirmación de cambios en la sección **Commit Changes** . 34 | {% endif %} 35 | 36 | Si necesitas ayuda buscando solución a tu problema, crea una publicación en [GitHub Community]({{ communityBoard }}). También puedes buscar otras publicaciones acerca de tu issue si otras personas lo han resuelto previamente. 37 | 38 |
39 |

Responderé abajo cuando detecte una confirmación de cambios en esta rama.

40 | -------------------------------------------------------------------------------- /responses/es/06_request-changes.md: -------------------------------------------------------------------------------- 1 | ## Paso 7: Responde a una revisión 2 | 3 | ¡Tu solicitud de extracción se ve súper bien! 4 | 5 | Agreguemos contenido a tu archivo. Reemplaza la línea 5 de tu archivo con una cita textual o con un meme y una leyenda graciosa. Recuerda: es posible usar el formato [Markdown](https://guides.github.com/features/mastering-markdown/). 6 | 7 | ### :keyboard: Actividad: Actualiza tu archivo 8 | 9 | {% if preferences.gitTool == 'cli' %} 10 | 1. Usa el comando checkout para cambiar de rama: 11 | ```shell 12 | git checkout {{ branch }} 13 | ``` 14 | 1. Abre el archivo `_posts/0000-01-02-{{ user.username }}.md`. 15 | 1. Reemplaza la línea 5 de tu archivo con algo nuevo. 16 | 1. Añade tus nuevos cambios: 17 | ```shell 18 | git add _posts/0000-01-02-{{ user.username }}.md 19 | ``` 20 | 1. Haz una confirmación de cambios para las modificaciones que acabas de hacer: 21 | ```shell 22 | git commit -m "" 23 | ``` 24 | 1. Sube tus cambios a GitHub: 25 | ```shell 26 | git push 27 | ``` 28 | 29 | {% elsif preferences.gitTool == 'vscode' %} 30 | 1. Abre el archivo `_posts/0000-01-02-{{ user.username }}.md`. 31 | 1. Reemplaza la línea 5 de tu archivo con algo nuevo. 32 | 1. Añade tus nuevos cambios. Recuerda: puedes hacer esto desde la vista de Source Control, haz clic en el símbolo **+** al lado del archivo. 33 | 1. Haz una confirmación de cambios. Puedes hacer esto desde la vista de Source Control, incluyendo un mensaje de confirmación en el recuadro de texto y después presionando Ctrl+Enter en Windows o Comando ⌘+Enter en macOS. 34 | 1. Sube tus cambios a GitHub. En la vista de Source Control, haz clic en los puntos suspensivos (...), y selecciona **Push**. 35 | 36 | {% else %} 37 | 1. Haz clic en [Files Changed tab]({{ url }}) en esta solicitud de extracción 38 | 1. Haz clic en el icono de lápiz que puedes encontrar al lado derecho de tu pantalla para editar el archivo que acabas de agregar. 39 | 1. Reemplaza la línea 5 con algo nuevo. 40 | 1. Navega hacia abajo y haz clic en **Commit Changes** 41 | {% endif %} 42 | 43 |
44 |

Responderé cuando detecte una confirmación de cambios en esta rama

45 | -------------------------------------------------------------------------------- /responses/es/07_pr-succeeds.md: -------------------------------------------------------------------------------- 1 | ## Paso 8: Fusiona tu solicitud de extracción 2 | 3 | Bien hecho @{{ user.username }}! :sparkles: 4 | 5 | Has creado una solicitud de extracción satisfactoriamente, y ha pasado todas las pruebas. Ahora puedes fusionar tu solicitud de extracción. 6 | 7 | ### :keyboard: Actividad: Fusiona tu solicitud de extracción 8 | 9 | {% if preferences.gitTool == 'cli' %} 10 | 1. Usa el checkout para cambiarte a la rama `main`: 11 | ```shell 12 | git checkout main 13 | ``` 14 | 2. Fusiona tu rama: 15 | ```shell 16 | git merge {{ branch }} 17 | ``` 18 | 3. Sube tu historial de fusión a GitHub: 19 | ```shell 20 | git push 21 | ``` 22 | 4. Elimina tu rama localmente: 23 | ```shell 24 | git branch -d {{ branch }} 25 | ``` 26 | {% else %} 27 | 1. Haz clic en **Merge pull request** 28 | 1. Haz clic en **Confirm merge** 29 | {% endif %} 30 | 1. Cuando tu rama se haya fusionado, ya no la vas a necesitar. Haz clic en **Delete branch**. 31 | 32 |
33 |

Responderé cuando esta solicitud de extracción se haya fusionado.

34 | -------------------------------------------------------------------------------- /responses/es/08_reminder-delete.md: -------------------------------------------------------------------------------- 1 | ## Buen trabajo 2 | 3 | ![celebra](https://octodex.github.com/images/collabocats.jpg) 4 | 5 | Felicidades @{{ user.username }}, ¡has completedo este curso! 6 | 7 | ## Qué fue lo que funcionó 8 | 9 | Ahora que has acabado el curso has implementado tu conjunto de diapositivas [aquí](https://{{ user.username }}.github.io/{{ repo }}) y has pasado por el flujo de GitHub. 10 | 11 | Antes de decir adiós, aquí te mostramos un resumen de todas las tareas que completaste en tu repositorio: 12 | 13 | - Aprendiste sobre las propuestas, las solicitudes de extracción, y la estructura de un repositorio en GitHub 14 | - Aprendiste sobre qué son las ramas en GitHub 15 | - Creaste una confirmación de cambios 16 | - Viste y respondiste a revisiones de solicitudes de extracción 17 | - Editaste un archivo ya existente 18 | - Habilitaste GitHub Pages 19 | - ¡Hiciste tu primera contribución! :tada: 20 | 21 | ## ¿Y ahora qué? 22 | 23 | Esperamos que este curso te haya ayudado a sentirte más a gusto usando GitHub. Recuerda: siempre eres bienvenido/a a repetir los temas del curso si necesitas más práctica. Si estás deseando aprender más, aquí te presentamos algunas ideas. 24 | 25 | ### Contribuye a un proyecto 26 | 27 | Para encontrar proyectos en los que puedes contribuir por medio de temas actuales y colecciones seleccionadas, revisa [GitHub Explore](https://github.com/explore). 28 | 29 | ### Sigue aprendiendo 30 | 31 | Encuentra aquí abajo sugerencias sobre los cursos que puedes tomar en el futuro: 32 | - [GitHub Pages]({{ host }}/githubtraining/github-pages): Continúa aprendiendo acerca de GitHub Pages. Este fue un tema que tocamos brevemente en este curso. 33 | - [Comunicación usando Markdown]({{ host }}/githubtraining/communicating-using-markdown): Usamos un poco del formato Markdown en este curso, pero si quieres aprender todo acerca sobre su sintaxis :sparkles:, toma el curso! 34 | 35 | [¿Qué más aprenderás]({{ host }}/courses)? 36 | -------------------------------------------------------------------------------- /responses/es/08_reopen.md: -------------------------------------------------------------------------------- 1 | ### :keyboard: Actividad: Vuelve a abrir tu solicitud de extracción 2 | 3 | Oooops! Parece que has cerrado tu solicitud de extracción accidentalmente. 4 | 5 | 1. Haz clic en **Reopen pull request**. Si este botón esta inactivo, primero tendrás que hacer clic en **Restore branch**. 6 | 1. Fusiona tu solicitud de extracción. 7 | 8 |
9 |

Responderé cuando esta solicitud de extracción haya sido fusionada.

10 | -------------------------------------------------------------------------------- /responses/fr/00_assign-yourself.md: -------------------------------------------------------------------------------- 1 | ## Étape 1: Assignation 2 | 3 | Les Issues non assignées ne sont sous la responsabilité de personne. Lorsque vous êtes assigné à une Issue ou une Pull Request, les visiteurs du dépôt sont informés que vous êtes le facilitateur de la discussion ou de la tâche :muscle:. 4 | 5 | ### :keyboard: Activité 6 | 7 | 1. Sur la partie droite de l'écran, sous la section "Assignees", cliquez l'icône engrenage et séléctionnez vous. 8 | 9 | Pour obtenir une version imprimable des étapes de ce cours, visitez le [Quick Reference Guide]({{ host }}/public/{{ course.slug }}.pdf). 10 | 11 |
12 |

Je vous réponderai dès que vous vous serez assigné cette Issue.

13 | 14 | > _Parfois je réponds trop rapidement et la page n'a pas le temps de s'actualiser. Si vous avez effectué l'action espérée et que vous ne voyez pas de réponse de ma part, attendez quelques secondes et rafraîchissez la page afin d'obtenir les prochaines instructions._ 15 | -------------------------------------------------------------------------------- /responses/fr/00_introduction.md: -------------------------------------------------------------------------------- 1 | # :wave: Bienvenue au cours "Introduction à GitHub" de GitHub Learning Lab 2 | 3 | Pour commencer, je vais vous guider à travers quelques premières étapes importantes de la programmation et la collaboration sur GitHub. 4 | 5 | :point_down: _Cette flèche signifie que vous pouvez agrandir la fenêtre. Cliquez dessus tout au long du cours pour trouver plus d'informations._ 6 |
Qu'est-ce que GitHub? 7 |
8 | 9 | ## Qu'est-ce que GitHub? 10 | 11 | Merci d'avoir posé cette question! Beaucoup de gens viennent sur GitHub parce qu'ils veulent contribuer à des projets libres (open source [:book:](https://help.github.com/articles/github-glossary/#open-source)), ou ils sont invités par des collègues ou des camarades de classe qui l'utilisent pour leurs projets. Pourquoi les gens utilisent-ils GitHub pour ces projets? 12 | 13 | **GitHub est une plateforme de collaboration.** 14 | 15 | Des logiciels aux documents juridiques, vous pouvez compter sur GitHub pour vous aider à réaliser le meilleur travail possible avec les outils de collaboration et de sécurité dont votre équipe a besoin. Avec GitHub, vous pouvez garder des projets complètement privés ou inviter des personnes à collaborer et fluidifier chaque étape de votre projet. 16 | 17 | **GitHub est également un puissant outil de contrôle de version.** 18 | 19 | GitHub utilise Git [:book:](https://help.github.com/articles/github-glossary/#git), l'outil open source de gestion de version le plus populaire, afin de tracer chaque contribution et contributeur [:book:](https://help.github.com/articles/github-glossary/#contributor) de votre projet, afin que vous sachiez d'où vient chaque ligne de code. 20 | 21 | **GitHub vous aide à faire beaucoup plus.** 22 | 23 | GitHub est utilisé pour créer certaines des technologies les plus avancées au monde. Que vous visualisiez des données ou construisiez un nouveau jeu, il existe toute une communauté et un ensemble d'outils sur GitHub qui peuvent vous aider à passer à l'étape suivante. Ce cours commence par les bases, mais nous approfondirons le reste plus tard! 24 | 25 | :tv: [Qu'est-ce que GitHub?](https://www.youtube.com/watch?v=w3jLJU7DT5E) 26 |
27 |

28 | 29 |
Exploration d'un dépôt GitHub 30 |
31 | 32 | ## Exploration d'un dépôt GitHub 33 | 34 | :tv: [Video: Exploration d'un dépôt](https://www.youtube.com/watch?v=R8OAwrcMlRw) 35 | 36 | ### Autres fonctionnalités 37 | 38 | La vidéo a couvert certaines des fonctionnalités les plus utilisées. Voici quelques autres éléments que vous pouvez trouver dans les dépôts GitHub : 39 | 40 | - Tableaux de suvi de projet : créez un tableau de suivi des tâches de style Kanban dans GitHub 41 | - Wiki : créer et stocker la documentation relative à votre projet 42 | - Insights : affichez des outils d'analyse pour votre dépôt, notamment : 43 | - Pulse: tableau de bord de projet pemettant la recherche d'information sur les travaux terminés et les travaux en cours 44 | - Graphiques : les graphiques fournissent une vue plus granulaire de l'activité du dépôt, donnant des détails sur qui a contribué au dépôt, qui l'a créé et quand les contributions ont été effectuées 45 | 46 | ### Fichiers spéciaux 47 | 48 | Dans la vidéo, vous avez découvert un fichier spécial appelé README.md. Voici quelques autres fichiers spéciaux que vous pouvez ajouter à vos dépôts : 49 | 50 | - CONTRIBUTING.md: Le fichier `CONTRIBUTING.md` est utilisé pour décrire le processus de contribution aux dépôts. Un lien vers le fichier `CONTRIBUTING.md` est affiché chaque fois que quelqu'un crée une nouvelle Issue ou une Pull Request. 51 | - ISSUE_TEMPLATE.md: ISSUE_TEMPLATE.md est un autre fichier que vous pouvez utiliser pour préremplir le corps d'une Issue. Par exemple, si vous avez toujours besoin des mêmes types d'informations pour les rapports de bugs, incluez-les dans le modèle d'Issue, et chaque nouvelle Issue sera ouverte avec votre texte de démarrage recommandé. 52 | 53 |
54 |
55 | 56 | ### Utiliser les Issues 57 | 58 | Ceci est une Issue [:book:](https://help.github.com/articles/github-glossary/#issue): un endroit où vous pouvez avoir des conversations sur les bugs dans votre code, la révision du code et à peu près tout le reste. 59 | 60 | Les titres des Issues sont comme les lignes d'objet des e-mails. Ils indiquent à vos collaborateurs de quoi il s'agit en un coup d'œil. Par exemple, le titre de cette Issue est "Getting started with GitHub". 61 | 62 |
Utiliser les Issues GitHub 63 | 64 | ## Utiliser les Issues GitHub 65 | 66 | Les Issues sont utilisées pour discuter des idées, des améliorations, des tâches et des bugs. Elles facilitent la collaboration en : 67 | 68 | - Fournissant à tout le monde (même aux futurs membres de l'équipe) l'historique complet en un seul endroit 69 | - En permettant les références croisées avec d'autres Issues et Pull Requests [:book:](https://help.github.com/articles/github-glossary/#pull-request) 70 | - Centralisant dans un dépôt unique les décisions et leurs motivations 71 | - Vous permettant d'inclure facilement les bonnes personnes et les bonnes équipes dans une conversation avec les @-mentions 72 | 73 | :tv: [Video: Utiliser les Issues GitHub](https://www.youtube.com/watch?v=Zhj46r5D0nQ) 74 | 75 |
76 |
77 | 78 |
Gérer les notifications 79 |
80 | 81 | ## Gérer les notifications 82 | 83 | :tv: [Video: Watching, notifications, stars, et explore](https://www.youtube.com/watch?v=ocQldxF7fMY) 84 | 85 | Une fois que vous avez commenté une Issue ou une Pull Request, vous commencerez à recevoir des notifications par e-mail dès lors qu'il y aura de l'activité dans le fil d'actualité. 86 | 87 | ### Comment faire taire ou réactiver des Issues spécifiques 88 | 89 | 1. Aller à l'Issue ou la Pull Request 90 | 2. Sous _"Notifications"_, cliquez le bouton **Unsubscribe** à droite afin de taire les notifications ou le bouton **Subscribe** afin de les activer 91 | 92 | Vous verrez une courte description qui explique votre statut de notification actuel. 93 | 94 | ### Comment personnaliser les notifications dans vos réglages 95 | 96 | 1. Cliquez votre photo de profil 97 | 2. Cliquez **Settings** 98 | 3. Cliquez **Notifications** depuis le menu de gauche et [ajustez vos préférences de notification](https://help.github.com/articles/managing-notification-delivery-methods/) 99 | 100 | ### Options de notification du dépôt 101 | 102 | * **Watch**: Vous recevrez une notification lorsqu'une nouvelle Issue, une Pull Request ou un commentaire est publié, et lorsqu'une Issue est fermé ou qu'une Pull Request est fusionnée 103 | * **Not watching**: Vous ne recevrez plus de notifications sauf si vous êtes @-mentionné 104 | * **Ignore**: Vous ne recevrez plus de notifications du dépôt 105 | 106 | ### Comment configurer les notifications des dépots que vous suivez 107 | 108 | 1. Cliquez votre photo de profil 109 | 1. Cliquez **Settings** 110 | 1. Cliquez **Notifications** depuis le menu de gauche 111 | 1. Cliquez sur le lien ["things you’re watching"](https://github.com/watching) 112 | 1. Sélectionnez l'onglet **Watching** t 113 | 1. Cliquez le bouton **Unwatch** pour désactiver les notifications, ou **Watch** les activer 114 | 115 |
116 |
117 | 118 |
119 |

Continuez à lire ci-dessous pour trouver votre première tâche

120 | -------------------------------------------------------------------------------- /responses/fr/01_turn-on-gh-pages.md: -------------------------------------------------------------------------------- 1 | ## Étape 2: Activez GitHub Pages 2 | 3 | :tada: Vous êtes maintenant le fier gestionnaire de cette Issue ! Maintenant que vous vous êtes assigné, les personnes qui passent savent qu'elles sont les bienvenues pour participer, mais aussi que vous êtes chargé de faire avancer le sujet jusqu'à la ligne d'arrivée. :sunglasses:. 4 | 5 | ### Utilisons GitHub Pages 6 | 7 | Maintenant, au boulot ! GitHub Pages vous permet de servir un site statique à partir d'un dépot. Nous avons rempli ce dépot avec du contenu de site, mais le site rendu n'est pas visible pour le moment. Changeons cela. 8 | 9 | ### :keyboard: Activité: Activez GitHub Pages 10 | 11 | 1. Cliquez sur l'onglet [**Settings**]({{ repoUrl }}/settings) de ce dépôt 12 | 1. Défilez jusqu'à la section "GitHub Pages" 13 | 1. Depuis le menu déroulant "Source", selectionnez **main branch** 14 | 15 | > Note : même si vous voyez une option pour choisir un thème, n'appliquez pas de thème à ce stade. Nous avons protégé le code afin que vous ne puissiez pas apporter de modifications involontaires. Vous aurez la possibilité d'appliquer un thème une fois le cours terminé. 16 | 17 |
18 |

Je répondrai dans cette discussion lorsque j'aurai détecté que GitHub Pages a déployé votre site.

19 | 20 | > Activer GitHub Pages déclenche le déploiement de votre dépôt. Ceci peut prendre jusqu'à une minute. 21 | -------------------------------------------------------------------------------- /responses/fr/02_close-issue.md: -------------------------------------------------------------------------------- 1 | ## Étape 3: Fermeture de la discussion 2 | 3 | Vous avez activé GitHub Pages! 4 | 5 | Votre site est maintenant public. Jetez-y un oeil à l'adresse {{ pagesUrl }}. 6 | 7 | Maintenant que vous avez effectué les tâches, vous pouvez fermer l'Issue. Fermer une Issue informe les autres contributeurs que cette discussion ou tâche est terminée. 8 | 9 | ### :keyboard: Activité 10 | 11 | 1. Cliquez sur le boutton **Close issue** ci-dessous 12 | 13 |
14 |

Je vous répondrai quand vous aurez fermé cette issue.

15 | -------------------------------------------------------------------------------- /responses/fr/03_create-a-branch.md: -------------------------------------------------------------------------------- 1 | ## Étape 4: Création d'une branche 2 | 3 | Réalisons la première étape d'une démarche typique sur GitHub : la création d'une branche [:book:](https://help.github.com/articles/github-glossary/#branch). 4 | 5 |
Création d'une branche 6 | 7 | ## Création d'une branche 8 | 9 | :tv: [Video: Branches](https://www.youtube.com/watch?v=xgQmu81G1yY) 10 | 11 | Vous venez d'apprendre à créer une branche, la première étape du travail sur GitHub. 12 | 13 | Les branches sont des éléments importants de la démarche sur GitHub car elles nous permettent d'isoler le travail en cours de la branche principale `main`. En d'autres termes, le travail des autres est protégé pendant que vous mettez au point votre contribution. 14 | 15 | ### Conseils pour l'utilisation de branches 16 | 17 | Un projet seul peut avoir des centaines de branches, chacune comportant une nouvelle modification de la branche `main`. 18 | 19 | La meilleure façon de gérer ces branches quand on travaille en équipe est de veiller à les maintenir concises et éphémères. Autrement dit, une branche doit comporter une seule nouvelle fonctionalité ou correction de bug. Les incompréhensions entre contributeurs sont réduites lorsque les branches ne sont actives que quelques jours avant d'être fusionnées [:book:](https://help.github.com/articles/github-glossary/#merge) avec la branche `main`. 20 | 21 |
22 |
23 | 24 | ### :keyboard: Activité : Votre première branche 25 | 26 | {% if preferences.gitTool == 'cli' %} 27 | 1. Ouvrez votre interface de ligne de commande préférée, que nous appelerons votre shell à partir de maintenant. 28 | 1. Clonez cd dépôt : 29 | ```shell 30 | git clone {{ thePayload.repository.clone_url }} 31 | ``` 32 | 1. Naviguez vers ce dépôt dans votre shell : 33 | ```shell 34 | cd {{ thePayload.repository.name }} 35 | ``` 36 | 1. Créez une branche avec le nom que vous désirez. Vous pouvez également utiliser le nom suggéré ci-dessous. 37 | ```shell 38 | git branch my-slide 39 | ``` 40 | 1. Poussez la branche vers GitHub: 41 | ``` 42 | git push --set-upstream origin 43 | ``` 44 | 45 | {% elsif preferences.gitTool == 'vscode' %} 46 | 1. Téléchargez et installez [Visual Studio Code](https://code.visualstudio.com/Download) (aussi appelé VS Code) si vous ne l'avez pas déjà. 47 | 1. Dans VS Code, ouvrez la pallette de commandes (Command Palette) avec Ctrl+Shift+P sous Windows, ou Command ⌘+Shift+P sous macOS. Vous pourvez égalememnt consulter [la documentation officielle de VS Code](https://code.visualstudio.com/docs/editor/versioncontrol#_cloning-a-repository) sur la création de clones. 48 | 1. Tapez: `git clone` et pressez Enter 49 | ![a screenshot of vs code with the command palette open](https://user-images.githubusercontent.com/16547949/53639288-bcf9ec80-3bf6-11e9-9d18-d97167168248.png) 50 | 1. Collez l'adresse du dépôt dans la nouvelle fenêtre et pressez Enter: 51 | ```shell 52 | {{ thePayload.repository.clone_url }} 53 | ``` 54 | 1. Sélectionnez l'emplacement où sauvegarder le dépôt et cliquez **Choose folder**. Ouvrez ensuite l'emplacement que vous avez sélectionné. 55 | 1. Le répertoire du dépôt doit maintenant être ouvert dans votre espace de travail VS Code. Cliquez sur `main` en bas et à gauche de la fenêtre VS Code. Ceci ouvrira la palette avec les commandes relatives aux branches Git. 56 | ![a screenshot of the Git branches in VS Code](https://user-images.githubusercontent.com/16547949/53639606-adc76e80-3bf7-11e9-98ac-bd41ae2b40db.png) 57 | 1. Cliquez sur **Create new branch** et saisissez le nom que vous désirez, par exemple `my-slide`. Pressez ensuite Enter. 58 | 1. Lorsqu'il vous est demandé de sélectioner la référence à partir de laquelle créer la branche, sélectioner `main`. 59 | 1. Allez dans la vue "Source Control", cliquez sur les points de suspension (...) et séléctionnez **Push**. Confirmez lorsque le boite de dialogue vous propose de publier la branche. 60 | ![a screenshot of the source control view in VS Code](https://user-images.githubusercontent.com/16547949/53640015-ee73b780-3bf8-11e9-8c90-be9022b9555a.png) 61 | 62 | {% else %} 63 | 64 | 1. Naviguez vers [l'onglet Code]({{ thePayload.repository.html_url }}) 65 | 2. Cliquez **Branch: main** dans la liste déroulante 66 | 3. Dans le champs de texte, saisissez un nom de branche, tel que `my-slide` 67 | 4. Cliquez **Create branch: ** ou pressez la touche Enter pour créer votre branche 68 | 69 | {% endif %} 70 |
71 |

Je vous répondrai ici lorsque j'aurai détecté qu'une nouvelle branche a été crée dans ce dépôt.

72 | -------------------------------------------------------------------------------- /responses/fr/03_head-to-branch.md: -------------------------------------------------------------------------------- 1 | ## Cette Issue est close! :white_check_mark: 2 | 3 |
4 |

Procédez à la prochaine tâche maintenant !

5 | -------------------------------------------------------------------------------- /responses/fr/03_your-first-contribution.md: -------------------------------------------------------------------------------- 1 | ### Introduction au flux GitHub 2 | 3 | Maintenant que vous connaissez les Issues, utilisons ce problème pour suivre votre cheminement vers votre première contribution. 4 | 5 | Les gens utilisent différents workflows pour contribuer à des projets logiciels, mais le moyen le plus simple et le plus efficace de contribuer sur GitHub est le workflow GitHub. 6 | 7 | :tv: [Video: Comprendre le flux GitHub](https://www.youtube.com/watch?v=PBI2Rz-ZOxU) 8 | 9 |
10 |

Lisez les étapes suivantes ci-dessous

11 | -------------------------------------------------------------------------------- /responses/fr/04_commit-something.md: -------------------------------------------------------------------------------- 1 | ## Étape 5: Soumettre un fichier 2 | 3 | :tada: Vous avez créé une branche! 4 | 5 | Créer une branche vous permet d'apporter des modifications à votre projet sans changer `main`, la branche déployée. Maintenant que vous avez une branche, il est temps de créer un fichier et d'effectuer votre première contribution! 6 | 7 |
Bases de la contribution 8 | 9 | ## Bases de la contribution 10 | 11 | Lorsque vous avez fini la création ou l'édition d'un fichier sur GitHub, faites défiler la page jusqu'en bas et répérez la section "Commit new file". 12 | 13 | Saisissez un intitulé à la contribution. Ce message doit informer rapidement les contributeurs sur l'objet du changement introduit dans le fichier. 14 | 15 | ### Règles de bienséance pour l'écriture d'un intitulé de contribution: 16 | 17 | - Ne pas terminer votre message par un point. 18 | - Restreignez votre message à 50 caractères ou moins. Ajoutez si nécessaire les détails complémentaires dans la fenêtre de description étendue. Elle se situe juste sous la ligne d'intitulé. 19 | - Utilisez la forme active. Par exemple, "Ajout" au lieu de "Ajouté" and "correction" au lieu de "corrigé". 20 | - Considérez votre intitulé de contribution comme l'expression de votre intention lors de l'introduction du changement. 21 | 22 |
23 |
24 | 25 | ### :keyboard: Activité: Votre première contribution 26 | 27 | Les prochaines étapes vous guideront à travers le processus de soumission d'un changement sur GitHub. 28 | 29 | {% if preferences.gitTool == 'cli' %} 30 | 1. Récupérez votre branche: 31 | ```shell 32 | git checkout {{ thePayload.ref }} 33 | ``` 34 | 1. Créez un nouveau fichier nommé `_posts/0000-01-02-{{ user.username }}.md`. 35 | 1. Ajoutez le contenu suivant à votre fichier : 36 | ```yaml 37 | --- 38 | layout: slide 39 | title: "Welcome to our second slide!" 40 | --- 41 | Your text 42 | Use the left arrow to go back! 43 | ``` 44 | 1. Ajoutez votre fichier à l'espace de travail: 45 | ```shell 46 | git add _posts/0000-01-02-{{ user.username }}.md 47 | ``` 48 | 1. Soumettez le fichiez en fournissant un intitulé : 49 | ```shell 50 | git commit -m "" 51 | ``` 52 | 1. Envoyez votre contribution à GitHub: 53 | ```shell 54 | git push 55 | ``` 56 | 57 | {% elsif preferences.gitTool == 'vscode' %} 58 | 1. Dans le dossier `_posts`, créez un nouveau fichier nommé `0000-01-02-{{ user.username }}.md`. Le nom complet de votre fichier doit être: `_posts/0000-01-02-{{ user.username }}.md`. 59 | 1. Ajoutez le contenu suivant à votre fichier et enregistrez-le : 60 | ```yaml 61 | --- 62 | layout: slide 63 | title: "Welcome to our second slide!" 64 | --- 65 | Your text 66 | Use the left arrow to go back! 67 | ``` 68 | 1. Pour ajouter votre fichier à l'espace de travail : allez dans la vue Source Control et cliquez le bouton **+** à côté du fichier. Vous pouvez également vous référer à [la documentation officielle de VS Code](https://code.visualstudio.com/docs/editor/versioncontrol#_commit). 69 | ![a screenshot of the staging button in the source control view](https://user-images.githubusercontent.com/16547949/53641057-d5b8d100-3bfb-11e9-9b69-53b0661cd5cd.png) 70 | 1. Soumetez le changement en saisissant un intitulé dans le champ de texte puis en pressant Ctrl+Enter sur Windows ou Command ⌘+Enter sur macOS. 71 | ![a screenshot of the commit message on VS Code](https://user-images.githubusercontent.com/16547949/53641276-698a9d00-3bfc-11e9-9b3d-01680fd01d7c.png) 72 | 1. Cliquez sur les points de suspension (...) et sélectionnez **Push**. 73 | 74 | {% else %} 75 | 1. Sur cette branche, créez un dossier `_posts` et ajoutez y un nouveau fichier nommé `0000-01-02-{{ user.username }}.md`. Vous pouvez le faire en utilisant [ce raccourci]({{ thePayload.repository.html_url }}/new/{{ thePayload.ref }}?filename=_posts/0000-01-02-{{ user.username }}.md) ou manuellement comme suit: 76 | - Retournez à l'onglet "Code" 77 | - Dans la liste déroulante des branches, sélectionnez "{{ thePayload.ref }}" 78 | - Cliquez **Create new file** 79 | - Dans le champ "file name", saisissez `_posts/0000-01-02-{{ user.username }}.md`. La saisie de `/` dans le nom de fichier placera automatiquement votre fichier dans le répertoire `_posts`. 80 | 1. Lorsque vous aurez nommé le fichier, ajoutez-y le contenu suivant: 81 | ```yaml 82 | --- 83 | layout: slide 84 | title: "Welcome to our second slide!" 85 | --- 86 | Your text 87 | Use the left arrow to go back! 88 | ``` 89 | 1. Après avoir ajouté le texte, vous pouvez soumettre le changement en fournissant un intitulé dans le champ de texte sous la fenêtre d'édition du fichier. Des recommendations relatives aux intitulés de soumission sont disponibles via le lien déroulant **Bases de la contribution**, juste au-dessus de ces instructions 90 | 1. Une fois saisis votre intitulé de contribution, cliquez **Commit new file** 91 | {% endif %} 92 |
93 |

Je vous répondrai lorsque j'aurai détecté une nouvelle contibution sur cette branche.

94 | -------------------------------------------------------------------------------- /responses/fr/05_open-a-pr.md: -------------------------------------------------------------------------------- 1 | ## Étape 6: Ouvrez une Pull Request 2 | 3 | Bravo pour cette contribution :sparkles: 4 | 5 | Maintenant que vous avez créé une contribution, il est temps de partager la modification que vous proposez via une Pull Request ! Là où les Issues encouragent l'échange avec d'autres contributeurs et collaborateurs sur un projet, les Pull Request vous aident à partager vos modifications, à recevoir des commentaires à leur sujet et à itérer jusqu'à ce qu'elles soient parfaites ! 6 | 7 |
Qu'est-ce qu'une Pull Request ? 8 | 9 | ## Pull requests 10 | 11 | Revenons au workflow de GitHub. Vous avez créé une branche, ajouté un fichier et validé le fichier dans votre branche. Il est maintenant temps de collaborer sur votre dossier avec d'autres étudiants qui suivent ce cours. Cette collaboration se produit dans une Pull Request. Visionnez cette vidéo pour en savoir plus : 12 | 13 | :tv: [Video: Introduction aux Pull Requests](https://youtu.be/kJr-PIfLDl4) 14 |
15 |
16 | 17 | Cette Pull Request va conserver les modifications que vous venez de faire sur votre branche tout en proposant de les appliquer également à la branche `main`. 18 | 19 | ### :keyboard: Activité: Créer une Pull Request 20 | 21 | 1. Ouvrez une Pull Request grâce à [ce raccourci]({{ url }}) ou manuellement comme suit : 22 | - Depuis l'onglet "Pull requests", cliquez **New pull request** 23 | - Dans le menu déroulant "base:", assurez vous que la branche `main` est sélectionnée 24 | - Dans le menu déroulant "compare:", sélectionnez "{{ branch | remove: 'refs/heads/' }}" 25 | 1. Lorsque vous avez sélectionné votre branche, saisissez un titre pour votre Pull Request. Par exemple `Ajout du fichier de {{ user.username }}` 26 | 1. Le champ suivant vous aide à fournir une description des modifications que vous avez apportées. N'hésitez pas à ajouter une description de ce que vous avez accompli jusqu'à présent. Pour rappel, vous avez: créé une branche, créé un fichier et effectué une contribution, et ouvert une Pull Request 27 | 1. Cliquez **Create pull request** 28 | 29 |
30 |

Je vous répondrai dans votre nouvelle Pull Request.

31 | -------------------------------------------------------------------------------- /responses/fr/06_fix-base.md: -------------------------------------------------------------------------------- 1 | Votre branche de référence doit être nommée `main`. Ouvrons une Pull Request afin de corriger cela. 2 | 3 | ### :keyboard: Activité: Modifier la direction de la Pull Request 4 | 5 | 1. Cliquez sur le bouton **Edit** situé à droite du titre de la PR 6 | 1. Sous le champ de texte du titre, dans le menu déroulant "base:", assurez vous que la branche `main` est sélectionnée 7 | 1. Une boite de dialogue apparaitra vous demandeant si vous voulez changer la base. Cliquez le bouton vert **Change base** 8 | 9 | Si vous avez besoin d'assistance, créez une conversation sur le forum [GitHub Community]({{ communityBoard }}). Vous pouvez également y effectuer une recherche et vérifiez si d'autres n'ont pas rencontré et résolu un problème similaire dans le passé. 10 | 11 |
12 |

Je vous répondrai lorsque j'aurai détecté que la référence d'oririne de cette PR a été modifiée.

13 | -------------------------------------------------------------------------------- /responses/fr/06_fix-body.md: -------------------------------------------------------------------------------- 1 | Les bonnes Pull Requests comportent une description qui informe les autres contributeurs du changement que vous suggérez et de son contexte. 2 | 3 | Editons cette Pull Request afin d'ajouter une description. 4 | 5 | ## :keyboard: Activité: Améliorer la Pull Request 6 | 7 | 1. Le premier commentaire de votre Pull Request comportera le texte par défaut **No description provided**. Cliquez l'icône **...** située en haut à droite de la boite de commentaire, puis cliquez sur **Edit** afin d'effectuer un changement 8 | 1. Ajoutez dans la boite de commentaire une description du changement que vous avez effectué. N'hésitez pas à décrire ce que vous avez accompli jusque là. Pour rappel, vous avez : créé une branche, créé un fichier et soumis une contribution puis ouvert une Pull Request 9 | 1. Cliquez sur le bouton vert **Update comment** en bas à droite de la boite de commentaire 10 | 11 | Si vous avez besoin d'assistance, créez une convesation sur le forum [GitHub Community]({{ communityBoard }}). Vous pouvez également y effectuer une recherche et vérifier si d'autres n'ont pas rencontré et résolu un problème similaire dans le passé. 12 | 13 |
14 |

Je vous répondrai lorsque j'aurai détecté que le corps de cette Pull Request a été édité.

15 | -------------------------------------------------------------------------------- /responses/fr/06_fix-filename.md: -------------------------------------------------------------------------------- 1 | J'espérai que votre fichier soit nommé **{{ expected }}**. 2 | 3 | Editons cette Pull Request afin de corriger ce problème. 4 | 5 | ## :keyboard: Activité: Corriger votre Pull Request 6 | 7 | {% if preferences.gitTool == 'cli' %} 8 | 1. Récupérez votre branche : 9 | ```shell 10 | git checkout {{ branch }} 11 | ``` 12 | 1. Tapez `ls` afin d'obtenir le contenu votre répertoire racine. 13 | 1. Confirmez que vous possédez un répertoire nommé `_posts`. 14 | 1. Déplacez vous dans le répertoire à l'aide de la commande `cd _posts`. 15 | 1. Tapez `ls` afin d'obtenir le contenu votre répertoire `_posts`. 16 | 1. Vérifiez que vous possédez un fichier nommé `{{ expected }}`. 17 | 1. Si vous constatez que vous devez effectuer des changements, ajoutez les à l'espace de travail, soumettez puis publiez les : 18 | ```shell 19 | git add . 20 | git commit -m "" 21 | git push 22 | ``` 23 | {% else %} 24 | 1. Cliquez [l'onglet Files Changed]({{ url }}) dans cette Pull Request 25 | 1. Vérifiez que le seul fichier édité se nomme `{{ expected }}`. 26 | 1. Si le fichier n'est pas correctement nommé, ou n'est pas au bon endroit, utilisez la fonctionalité d'édition afin de corriger cela. 27 | 1. Au dessus du contenu du fichier, sélectionnez tout le texte du champ contenant le nom du fichier et supprimez ce texte. 28 | 1. Continuez de presser la touche retour arrière (Backspace) afin de supprimer également d'éventuels noms de répertoire. 29 | 1. Saisissez le nom de fichier correct: 30 | ```shell 31 | {{ expected }} 32 | ``` 33 | 1. Faites défiler la fenêtre jusqu'en bas puis, dans la section **Commit Changes**, saisissez un intitulé de contribution et soumettez le. 34 | {% endif %} 35 | 36 | **Note**: Vous ne trouvez pas le bouton d'édition du fichier ? Il peut ressemble à un crayon ou a des points de suspension. 37 | 38 | ISi vous avez besoin d'assistance, créez une convesation sur le forum [GitHub Community]({{ communityBoard }}). Vous pouvez également y effectuer une recherche et vérifier si d'autres n'ont pas rencontré et résolu un problème similaire dans le passé. 39 | 40 |
41 |

Je vous répondrai lorsque j'aurai détecté une contribution sur cette branche.

42 | -------------------------------------------------------------------------------- /responses/fr/06_request-changes.md: -------------------------------------------------------------------------------- 1 | ## Étape 7: Répondre à une relecture 2 | 3 | Votre Pull Request à l'air sensationelle! 4 | 5 | Continuons en ajoutant du contenu à votre fichier. Remplacez la ligne 5 de votre fichier par une citation ou un meme et une légende pleine d'esprit. N'oubliez pas: le [Markdown](https://guides.github.com/features/mastering-markdown/) est supporté. 6 | 7 | ### :keyboard: Activité : Modifier un fichier 8 | 9 | {% if preferences.gitTool == 'cli' %} 10 | 1. Récupérez votre branche: 11 | ```shell 12 | git checkout {{ branch }} 13 | ``` 14 | 1. Ouvrez le fichier `_posts/0000-01-02-{{ user.username }}.md`. 15 | 1. Remplacez la ligne 5 du fichier par quelque chose de nouveau. 16 | 1. Ajoutez vos changements à l'espace de travail : 17 | ```shell 18 | git add _posts/0000-01-02-{{ user.username }}.md 19 | ``` 20 | 1. Soumettez vos changements : 21 | ```shell 22 | git commit -m "" 23 | ``` 24 | 1. Publiez vers GitHub : 25 | ```shell 26 | git push 27 | ``` 28 | 29 | {% elsif preferences.gitTool == 'vscode' %} 30 | 1. Ouvrez le fichier `_posts/0000-01-02-{{ user.username }}.md`. 31 | 1. Remplacez la ligne 5 du fichier par quelque chose de nouveau. 32 | 1. Ajoutez vos changements à l'espace de travail. Pour rappel, vous pouvez effectuer cela dans la vue Source Control, cliquez le symbole **+** à côté du fichier. 33 | 1. Soumettez vos changements. Ceci peut se faire depuis la vue Source Control : saisissez un message de commit dans le champ de texte et pressez Ctrl+Enter sous Windows ou Command ⌘+Enter sous macOS. 34 | 1. Publiez vers GitHub. Dans la vue Source Control, cliquez sur les points de suspension (...) et sélectionnez **Push**. 35 | 36 | {% else %} 37 | 1. Cliquez [l'onglet Files Changed]({{ url }}) de cette Pull Request 38 | 1. Editez votre fichier nouvellement ajouté 39 | 1. Remplacez la ligne 5 du fichier par quelque chose de nouveau 40 | 1. Défilez vers le bas et cliquez **Commit Changes** 41 | {% endif %} 42 | 43 | **Note**: Vous ne trouvez pas le bouton d'édition du fichier ? Il peut ressemble à un crayon ou a des points de suspension. 44 | 45 |
46 |

Je vous répondrai lorsque j'aurai détecté une nouvelle contibution sur cette branche.

-------------------------------------------------------------------------------- /responses/fr/07_pr-succeeds.md: -------------------------------------------------------------------------------- 1 | ## Étape 8: Fusionnez votre Pull Request 2 | 3 | Bien joué @{{ user.username }} ! :sparkles: 4 | 5 | Vous avez créé avec succès une Pull Request et elle a passé tous les tests avec succès. Vous pouvez maintenant fusionner votre Pull Request. 6 | 7 | ### :keyboard: Activité: Fusionnez votre Pull Request 8 | 9 | {% if preferences.gitTool == 'cli' %} 10 | 1. Récupérez votre branche `main` : 11 | ```shell 12 | git checkout main 13 | ``` 14 | 2. Fusionnez votre branche : 15 | ```shell 16 | git merge {{ branch }} 17 | ``` 18 | 3. Publiez l'historique combiné vers GitHub : 19 | ```shell 20 | git push 21 | ``` 22 | 4. Supprimez la branche locale : 23 | ```shell 24 | git branch -d {{ branch }} 25 | ``` 26 | {% else %} 27 | 1. Cliquez sur **Merge pull request** 28 | 1. Cliquez sur **Confirm merge** 29 | {% endif %} 30 | 1. Une fois votre branche fusionnée, vous n'en avez plus besoin. Cliquez **Delete branch**. 31 | 32 |
33 |

Je vous répondrai lorsque cette Pull Request sera fusionnée.

34 | -------------------------------------------------------------------------------- /responses/fr/08_reminder-delete.md: -------------------------------------------------------------------------------- 1 | ## Bon boulot 2 | 3 | ![celebrate](https://octodex.github.com/images/collabocats.jpg) 4 | 5 | Félicitations @{{ user.username }}, vous avez achevé ce cours ! 6 | 7 | ## Les temps forts 8 | 9 | Vous avez désormais votre présentation déployée [ici](https://{{ user.username }}.github.io/{{ repo }}) et vous l'avez fait en suivant le workflow de GitHub. 10 | 11 | Avant de vous dire au revoir, récapitulons les tâches accomplies dans ce dépôt: 12 | 13 | - Vous avez effectué votre première contribution ! :tada: 14 | - Vous avez découvert les Issues, les Pull Requests et la structure d'un dépôt GitHub 15 | - Vous avez découvert les branches 16 | - Vous avez créé une soumission 17 | - Vous avez consulté et répondu aux relectures sur les Pull Requests 18 | - Vous avez édité un fichier existant 19 | - Vous avez activé GitHub Pages 20 | - Vous avez effectuer votre première contribution ! 21 | 22 | ## Partagez vos commentaires 23 | 24 | Nous aimerions savoir ce que vous avez pensé de ce cours. Merci de partager votre opinion dans [cette enquête rapide](https://www.surveymonkey.com/r/intro-to-github-1). 25 | 26 | ## Prochaine étape 27 | 28 | Nous espérons que ce cours vous a aidé à vous sentir plus à l'aise avec GitHub. N'oubliez pas : vous pouvez toujours répéter les sujets du cours si vous souhaitez vous entraîner davantage. Si vous êtes prêt à développer vos nouvelles compétences, voici ci-dessous quelques idées. 29 | 30 | ### Contribuez à un projet 31 | 32 | Trouvez des projets auxquels contribuer en consultant [GitHub Explore](https://github.com/explore). Les projets y sont regroupés par sujets populaires ou dans des collections organisées. 33 | 34 | ### Continuez à apprendre 35 | 36 | Voici quelques suggestions de futurs cours que vous pourrez suivre : 37 | - [GitHub Pages]({{ host }}/{{ course.Owner.login }}/github-pages): Continuez à en apprendre davantage sur GitHub Pages, que nous avons abordées dans ce cours. 38 | - [Communication à l'aide de Markdown]({{ host }}/{{ course.Owner.login }}/communicating-using-markdown): Nous avons utilisé un peu de Markdown dans ce cours, mais si vous voulez tout savoir au sujet de cette :sparkles: syntaxe, suivez le cours! 39 | 40 | [Qu'allez vous apprendre maintenant]({{ host }}/courses)? 41 | -------------------------------------------------------------------------------- /responses/fr/08_reopen.md: -------------------------------------------------------------------------------- 1 | ### :keyboard: Activité : Rouvrir une Pull Request 2 | 3 | Oooops! Il semble que vous ayez accidentellement fermé votre Pull Request. 4 | 5 | 1. Cliquez **Reopen pull request**. Si ce bouton n'est pas actif, il vous faudra d'abord cliquer sur **Restore branch** 6 | 1. Fusionnez la Pull Request. 7 | 8 |
9 |

Je vous répondrai lorsque cette Pull Request aura été fusionnée.

10 | -------------------------------------------------------------------------------- /responses/ja/00_assign-yourself.md: -------------------------------------------------------------------------------- 1 | ## ステップ１：担当者になろう 2 | 3 | イシューに担当者が設定されていない状態では、誰がオーナーかがわかりません。イシューやプルリクエストの担当になることで、リポジトリを見に来る人やコントリビュートしようとしている人たちにそのタスクの議論をリードするのはあなたであると示すことが出来ます :muscle:。 4 | 5 | ### :keyboard: やってみよう 6 | 7 | 1. スクリーンの右側の「Assignees」セクションで、ギアアイコンをクリックし自分を選択しましょう。 8 | 9 | このコースのステップを印刷したい場合は、[Quick Reference Guide]({{ host }}/public/{{ course.slug }}.pdf)を参照ください。 10 | 11 |
12 |

このイシューにあなたが担当になったのを検知したら、このイシューに追加のコメントを書き込みます。

13 | 14 | > _時々、追加のコメントが書き込まれないことがあります！正しい操作をしたにも関わらず何のコメントも書き込まれない場合は、数秒待ってからこのページを再読込してください。_ 15 | -------------------------------------------------------------------------------- /responses/ja/00_introduction.md: -------------------------------------------------------------------------------- 1 | # :wave: GitHubラーニングラボの"Introduction to GitHub"コースへようこそ 2 | 3 | まずはじめに、GitHubを使ってコーディングをしたりコラボレーションするのに大事ないくつかのポイントを紹介しましょう。 4 | 5 | :point_down: _この矢印は中身を展開することが出来ます！より詳細な情報が必要なときにはコース中のこの矢印をクリックしましょう_ 6 |
GitHubとはなにか？ 7 |
8 | 9 | ## GitHubとはなにか？ 10 | 11 | よくぞ聞いてくれました！多くの人がGitHubにアクセスするのは、オープンソース [:book:](https://help.github.com/articles/github-glossary/#open-source) プロジェクトにコントリビュートするためであったり、チームメイトやクラスメイトが彼らのプロジェクトでGitHubを使っていてそこに招待されたからです。では、なぜ人々はプロジェクトにGitHubを使うのでしょうか？ 12 | 13 | **GitHubはコラボレーションプラットフォームです。** 14 | 15 | ソフトウェアから法的文書まで、GitHub上でのコラボレーションとチームが必要とするセキュリティツールによって、最善の仕事をすることができるのです。GitHubを使えば、プロジェクトを完全にプライベートにする事もできますし、世界中のメンバーとコラボレーションすることも出来ますし、プロジェクトのプロセスを円滑にすることも出来ます。 16 | 17 | **GitHubは強力なバージョン管理ツールでもあります。** 18 | 19 | GitHubではGit [:book:](https://help.github.com/articles/github-glossary/#git) という、最も有名なオープンソースのバージョン管理ソフトウェアを使っており、プロジェクトの全てのコントリビュートとコントリビューター [:book:](https://help.github.com/articles/github-glossary/#contributor) を追跡出来ます。これによって、ソースコードのあらゆる行が誰がいつかいたのかを把握することが出来ます。 20 | 21 | **GitHubは人々がより多くの事を成し遂げる助けとなります** 22 | 23 | GitHubは世界で最も先進的な技術を構築することに使われています。データの可視化であろうと、新しいゲームの作成だろうと、GitHub上には皆さんが次のレベルに到達するためのコミュニティとツールが揃っています。このコースは基本からスタートしますが、後半は徐々に深掘りしていきます！ 24 | 25 | :tv: [ビデオ：GitHubとはなにか？](https://www.youtube.com/watch?v=w3jLJU7DT5E) 26 |
27 |

28 | 29 |
GitHubリポジトリ概観 30 |
31 | 32 | ## GitHubリポジトリ概観 33 | 34 | :tv: [ビデオ：GitHubリポジトリ概観](https://www.youtube.com/watch?v=R8OAwrcMlRw) 35 | 36 | ### さらなる機能 37 | 38 | ビデオではGitHubで最も使われる機能のうちの一部を紹介しました。GitHubリポジトリでお使いいただける他の機能もいくつかここでご紹介します： 39 | 40 | - プロジェクトボード：GitHub上でカンバンスタイルのタスク管理ボードを作成することが出来ます 41 | - Wiki：プロジェクトのドキュメントを書くことが出来ます 42 | - Insights：以下のようなリポジトリの解析ツールへのリンクが表示されます： 43 | - Pulse：このプロジェクトダッシュボードでは完了した作業や実施中の作業についての情報を見つけることが出来ます 44 | - Graphs：誰がリポジトリにコントリビュートしているのか、誰がフォークしているのか、いつ作業を完成させたのかといったリポジトリに関するより詳細な情報を提供します 45 | 46 | ### 特別なファイル 47 | 48 | ビデオの中で、README.mdという名前の特別なファイルについて学びました。以下はリポジトリに追加できる他の特別なファイルです： 49 | 50 | - CONTRIBUTING.md: `CONTRIBUTING.md`はリポジトリに対してコントリビュートするためのプロセスを記載するのに使います。新しいイシューやプルリクエストを作成する際に、`CONTRIBUTING.md`ファイルへのリンクが表示されます。 51 | - ISSUE_TEMPLATE.md: `ISSUE_TEMPLATE.md`はイシューの本文に事前に含めておくことができる内容を記載するファイルです。例えば、バグ報告には常に同じ種類の情報が必要な場合、イシューテンプレートにその内容を含ることで、新しくイシューを作成する際に常にテンプレートの内容が入力された状態で表示されます。 52 | 53 |
54 |
55 | 56 | ### イシューを使ってみよう 57 | 58 | 今皆さんが見ているのはイシュー [:book:](https://help.github.com/articles/github-glossary/#issue) です：ここではあなたのコードのバグやコードレビューについて議論したり、他のあらゆる事を議論する事ができる場所です。 59 | 60 | イシュータイトルはメールの件名のようなものです。そのイシューがどういったものなのかをひと目で分かるようにするためのものです。例えば、このイシューのタイトルは「GitHubを始めよう」です。 61 | 62 |
GitHubイシューを使ってみよう 63 | 64 | ## GitHubイシューを使ってみよう 65 | 66 | イシューはアイデアや機能追加、タスク、バグについて議論するにの使われます。イシューを使うことによって以下のような理由でコラボレーションをやりやすくします： 67 | 68 | - 全員（将来のチームメンバーに対しても）に完全な話の流れを１つの場所で提供する 69 | - 他のイシューやプルリクエスト [:book:](https://help.github.com/articles/github-glossary/#pull-request) へのクロスリンクを貼ることができる 70 | - どのようにして、なぜある意思決定をしたのかについて１つの場所に網羅的な記録を残すことができる 71 | - @メンションを使うことで、議論に参加することが必要なメンバーやチームを簡単に呼ぶことができる 72 | 73 | :tv: [ビデオ；イシューを使ってみよう](https://www.youtube.com/watch?v=Zhj46r5D0nQ) 74 | 75 |
76 |
77 | 78 |
通知の管理 79 |
80 | 81 | ## 通知の管理 82 | 83 | :tv: [ビデオ：ウォッチ、通知、スター、探索](https://www.youtube.com/watch?v=ocQldxF7fMY) 84 | 85 | 一度イシューやプルリクエストにコメントを書くと、そのスレッドについてのメール通知を受け取るようになります。 86 | 87 | ### 特定の会話の通知のオン/オフのやり方 88 | 89 | 1. イシューやプルリクエストに移動 90 | 2. 画面右側の _"Notifications"_ セクションにて、通知をオフにするには**Unsubscribe**ボタン、通知をオンにするには　**Subscribe** ボタンを押す。 91 | 92 | ここでは現在の通知設定がどうなっているかが記載されています。 93 | 94 | ### Settings での通知のカスタマイズ方法 95 | 96 | 1. プロフィールアイコンをクリック 97 | 2. **Settings** をクリック 98 | 3. 画面左側のメニューにある **Notifications** をクリックし、 [通知の設定を行う](https://help.github.com/articles/managing-notification-delivery-methods/) 99 | 100 | ### リポジトリの通知設定 101 | 102 | * **Watch**: 新しいイシューやプルリクエスト、コメントが作られた時や、イシューがクローズされた時、プルリクエストがマージされた時に通知が送られる 103 | * **Not watching**: @メンションされた時以外は通知が送られる 104 | * **Ignore**: リポジトリからの通知は全く送られない 105 | 106 | ### ウォッチしているリポジトリの通知の設定方法 107 | 108 | 1. プロフィールアイコンをクリック 109 | 2. **Settings** をクリック 110 | 3. 画面左側のメニューにある **Notification** をクリック 111 | 4. [repositories you’re watching](https://github.com/watching) リンクをクリック 112 | 5. **Watching** タブを選択 113 | 6. 通知を無効化するには **Unwatch** ボタン、有効化する **Watch** ボタンをクリック 114 | 115 |
116 |
117 | 118 |
119 |

次に最初のタスクが書き込まれます

120 | -------------------------------------------------------------------------------- /responses/ja/01_turn-on-gh-pages.md: -------------------------------------------------------------------------------- 1 | ## ステップ２：GitHub Pagesを有効化しよう 2 | 3 | :tada: おめでとうございます、無事にこのイシューの担当者になりました！担当者に設定することで、このイシューを見かけた人が参加しやすくなりますが、今回は自分でタスク自体もやってしまいましょう。 :sunglasses: 4 | 5 | ### GitHub Pagesを使ってみよう 6 | 7 | GitHub Pagesはリポジトリから静的サイトを作る機能です。いくつかサイトのコンテンツをこのリポジトリに用意しておいたのですが、まだそのコンテンツのサイトは見えるようになっていません。設定を変更してみましょう。 8 | 9 | ### :keyboard: やってみよう：GitHub Pagesの有効化 10 | 11 | 1. このリポジトリの[**Settings**]({{ repoUrl }}/settings)タブをクリックしましょう 12 | 1. "GitHub Pages"のセクションまでスクロールダウンしましょう 13 | 1. "Source"ドロップダウンから、**main branch** を選択しましょう 14 | 15 | > 注意：テーマを選択できる設定が目に入ったとしても、現時点ではテーマの適用はしないでおきましょう。意図しない変更が入らないよう、コードは保護されています。コースが完了したら、テーマを設定できるようになります。 16 | 17 |
18 |

GitHub Pagesのサイトがデプロイされたら、このイシューにコメントを書き込みます。

19 | 20 | > GitHub Pagesを有効化すると、リポジトリのデプロイ処理が実行されます。デプロイを検知するまでに１分ほどかかることがあります。 21 | -------------------------------------------------------------------------------- /responses/ja/02_close-issue.md: -------------------------------------------------------------------------------- 1 | ## ステップ３：イシューをクローズしよう 2 | 3 | GitHub Pagesの有効化に成功しました！ 4 | 5 | サイトはパブリックに見えるようになっています。こちらから確認してみましょう {{ pagesUrl }} 。 6 | 7 | このイシューでのタスクは完了ですので、クローズしましょう！イシューを閉じることによって、他のコントリビューターにこのタスクについての議論は終了したと知らせることが出来ます。 8 | 9 | ### :keyboard: やってみよう 10 | 11 | 1. 下の**Close issue**ボタンをクリックしましょう 12 | 13 |
14 |

このイシューがクローズされたらコメントを書き込みます。

15 | -------------------------------------------------------------------------------- /responses/ja/03_create-a-branch.md: -------------------------------------------------------------------------------- 1 | ## ステップ４：ブランチを作ろう 2 | 3 | GitHubフローの最初のステップに取り掛かりましょう：つまりブランチの作成です[:book:](https://help.github.com/articles/github-glossary/#branch)。 4 | 5 |
ブランチの作成 6 | 7 | ## ブランチの作成 8 | 9 | :tv: [Video: Branches](https://www.youtube.com/watch?v=xgQmu81G1yY) 10 | 11 | さて、GitHubフローの最初のステップとしてブランチの作成方法を学びました。 12 | 13 | ブランチを作ることによって`main`ブランチからあなたの作業を分離することができるため、ブランチはGitHubフローにおいて重要な役割を果たします。言い換えれば、誰もが安全な場所でコントリビュートを始めることができるのです。 14 | 15 | ### ブランチを使う際のコツ 16 | 17 | １つのプロジェクトの中にブランチは何百と作成され、それぞれが`main`ブランチへの変更の提案となります。 18 | 19 | これらのブランチをチーム全体で管理可能な状態を保つには一つ一つのブランチを完結で短命に保つことが必要です。言い換えると、１つの新しい機能か１つのバグフィックスごとに１つのブランチを作成するべきです。こうすることで、ブランチが`main`ブランチにマージ [:book:](https://help.github.com/articles/github-glossary/#merge) されるまでのアクティブな期間を数日に保つことができ、他のコントリビューターが混乱する可能性を減らすことが出来ます。 20 | 21 |
22 |
23 | 24 | ### :keyboard: やってみよう：初めてのブランチ 25 | 26 | {% if preferences.gitTool == 'cli' %} 27 | 1. お好みのコマンドラインインターフェースを開きましょう。ここからはそのコマンドラインインターフェースのことをシェルと呼びます。 28 | 1. このリポジトリをクローンしましょう： 29 | ```shell 30 | git clone {{ thePayload.repository.clone_url }} 31 | ``` 32 | 1. シェル上でリポジトリに移動しましょう： 33 | ```shell 34 | cd {{ thePayload.repository.name }} 35 | ``` 36 | 1. ブランチを作成しましょう。ブランチ名は好きな名前で大丈夫です。下記の名前をそのまま使っても構いません： 37 | ```shell 38 | git branch my-slide 39 | ``` 40 | 1. ブランチをGitHubにプッシュしましょう： 41 | ``` 42 | git push --set-upstream origin 43 | ``` 44 | 45 | {% elsif preferences.gitTool == 'vscode' %} 46 | 1. もちまだインストールしていないのであれば[Visual Studio Code](https://code.visualstudio.com/Download) (VS Codeと呼ばれます)をダウンロードし、起動しましょう。 47 | 1. VS Codeの中で、コマンドパレットを開きましょう。コマンドパレットを開くには、WindowsではCtrl+Shift+P、macOSではCommand ⌘+Shift+Pを押します。クローンの際には[VS Codeの公式ドキュメント](https://code.visualstudio.com/docs/editor/versioncontrol#_cloning-a-repository)にも手順が記載されています。 48 | 1. `git clone`と入力し、Enterを押します。 49 | ![a screenshot of vs code with the command palette open](https://user-images.githubusercontent.com/16547949/53639288-bcf9ec80-3bf6-11e9-9d18-d97167168248.png) 50 | 1. 新しいウィンドウにリポジトリのURLを貼り付け、Enterを押します： 51 | ```shell 52 | {{ thePayload.repository.clone_url }} 53 | ``` 54 | 1. リポジトリを保存する場所を選択し、**Choose folder** をクリックします。その後、選択したフォルダーを開きましょう。 55 | 1. リポジトリのフォルダーがVS Codeのプロジェクトに開かれているはずです。VS Codeのウィンドウの左下にある`main`をクリックしましょう。Gitブランチに関連するコマンドが表示されたコマンドパレットが表示されるはずです。 56 | ![a screenshot of the Git branches in VS Code](https://user-images.githubusercontent.com/16547949/53639606-adc76e80-3bf7-11e9-98ac-bd41ae2b40db.png) 57 | 1. **Create new branch** をクリックし、好きなブランチ名を入力しましょう。例えば`my-slide`といったものです。その後、Enterを押します。 58 | 1. どのrefからブランチを作成するか尋ねられた場合、`main`を選択しましょう。 59 | 1. Source Controlビューに移動し、...をクリックし **Push** を選択します。ブランチを公開するか尋ねるダイアログボックスを確認しましょう。 60 | ![a screenshot of the source control view in VS Code](https://user-images.githubusercontent.com/16547949/53640015-ee73b780-3bf8-11e9-8c90-be9022b9555a.png) 61 | 62 | {% else %} 63 | 64 | 1. [Codeタブ]({{ thePayload.repository.html_url }})に移動しましょう 65 | 2. **Branch: main** ドロップダウンをクリックしましょう 66 | 3. 入力フィールドに、例えば`my-slide`のように、作成するブランチの名前を入力しましょう 67 | 4. **Create branch: ** をクリックするか、"Enter"キーを押し、ブランチを作成しましょう 68 | 69 | {% endif %} 70 |
71 |

このリポジトリで新しいブランチが作成されたら、新しいコメントを書き込みます。

72 | -------------------------------------------------------------------------------- /responses/ja/03_head-to-branch.md: -------------------------------------------------------------------------------- 1 | ## このイシューは完了です！ :white_check_mark: 2 | 3 |
4 |

さあ次のイシューに進みましょう！

5 | -------------------------------------------------------------------------------- /responses/ja/03_your-first-contribution.md: -------------------------------------------------------------------------------- 1 | ### GitHubフローの紹介 2 | 3 | さてイシューに慣れてきたところで、このイシューを使ってあなたの初めてのコントリビュートの道筋をたどってみましょう。 4 | 5 | プロジェクトによってコントリビュートのフローは異なりますが、GitHub上で最もシンプルで最も効率的なコントリビュートのやり方はGitHubフローです。 6 | 7 | :tv: [ビデオ：GitHubフローを理解する](https://www.youtube.com/watch?v=PBI2Rz-ZOxU) 8 | 9 |
10 |

以下を読み進めて、次のステップに移りましょう

11 | -------------------------------------------------------------------------------- /responses/ja/04_commit-something.md: -------------------------------------------------------------------------------- 1 | ## ステップ５：ファイルをコミットしよう 2 | 3 | :tada: ブランチを作成できました！ 4 | 5 | ブランチを作成することで、`main`ブランチに変更を加えることなくプロジェクトへの修正を行うことができるようになります。さて、ブランチの作成が完了したので、次はファイルを作成し、初めてのコミットを行いましょう！ 6 | 7 |
コミットの基礎 8 | 9 | ## コミットの基礎 10 | 11 | GitHub上で新しいファイルを作成したり、ファイルの修正をし終えたら、ページの下にスクロースしましょう。"Commit new file"セクションが見つかるはずです。 12 | 13 | 最初のフィールドにはコミットメッセージを入力します。コミットメッセージでは、このファイルに対して行った変更を他の人に完結に伝える必要があります。 14 | 15 | ### コミットメッセージを書く際の決まり： 16 | 17 | - コミットメッセージの終わりにピリオドは付けない 18 | - コミットメッセージは５０文字以内とする。必要であれば、詳細な情報は追加の詳細フィールドに記載する。これはタイトルのラインのすぐ下にあるフィールドです 19 | - 現在形を使う。例えば、「追加した」の代わりに「追加する」を書いたり、「マージした」の代わりに「マージする」と書く 20 | - ファイルを変更する上での意図を書く 21 | 22 |
23 |
24 | 25 | ### :keyboard: やってみよう：初めてのコミット 26 | 27 | 下記の手順に従うことによって、GitHub上に変更をコミットすることが出来ます。 28 | 29 | {% if preferences.gitTool == 'cli' %} 30 | 1. ブランチをチェックアウトしましょう： 31 | ```shell 32 | git checkout {{ thePayload.ref }} 33 | ``` 34 | 1. `_posts/0000-01-02-{{ user.username }}.md`という名前の新しいファイルを作成しましょう。 35 | 1. ファイルに下記の内容を追記しましょう： 36 | ```yaml 37 | --- 38 | layout: slide 39 | title: "２枚目のスライドにようこそ！" 40 | --- 41 | 何かを書く。 42 | 戻るには戻るボタンを使いましょう！ 43 | ``` 44 | 1. 新しいファイルをステージに追加しましょう： 45 | ```shell 46 | git add _posts/0000-01-02-{{ user.username }}.md 47 | ``` 48 | 1. テキストを追加し、変更とコミットメッセージをコミットしたら、手順のすぐ上にある**コミットの基礎**ドロップダウンを開き内容を確認しましょう： 49 | ```shell 50 | git commit -m "" 51 | ``` 52 | 1. Push your new commit to GitHub: 53 | ```shell 54 | git push 55 | ``` 56 | 57 | {% elsif preferences.gitTool == 'vscode' %} 58 | 1. `_posts`フォルダに`0000-01-02-{{ user.username }}.md`という名前の新しいファイルを作成しましょう。ファイルのパスは`_posts/0000-01-02-{{ user.username }}.md`となるはずです。 59 | 1. ファイルに以下の内容を追加し、保存しましょう： 60 | ```yaml 61 | --- 62 | layout: slide 63 | title: "２枚目のスライドにようこそ！" 64 | --- 65 | 何かを書く。 66 | 戻るには戻るボタンを使いましょう！ 67 | ``` 68 | 1. 新しいファイルをステージに追加するには：Source Controlビューに移動し、ファイルの横にある**+**ボタンをクリックしましょう。[VS Codeの公式ドキュメント](https://code.visualstudio.com/docs/editor/versioncontrol#_commit)にも手順が記載されています。 69 | ![a screenshot of the staging button in the source control view](https://user-images.githubusercontent.com/16547949/53641057-d5b8d100-3bfb-11e9-9b69-53b0661cd5cd.png) 70 | 1. テキストフィールドにコミットメッセージを入力し、Windowsの場合はCtrl+Enter、macOSの場合はCommand ⌘+Enterを押すことで変更をコミットしましょう。 71 | ![a screenshot of the commit message on VS Code](https://user-images.githubusercontent.com/16547949/53641276-698a9d00-3bfc-11e9-9b3d-01680fd01d7c.png) 72 | 1. ...をクリックし、**Push**を選択しましょう。 73 | 74 | {% else %} 75 | 1. このブランチに新しいファイルを作成しましょう。`_posts`フォルダーに`0000-01-02-{{ user.username }}.md`という名前のファイルを作成します。[このリンクをクリックする]({{ thePayload.repository.html_url }}/new/{{ thePayload.ref }}?filename=_posts/0000-01-02-{{ user.username }}.md)か、以下の手順でファイルを作成することが出来ます： 76 | - "Code"タブに戻る 77 | - ブランチドロップダウンにて、"{{ thePayload.ref }}"を選択 78 | - **Create new file**をクリック 79 | - "file name"フィールドに`_posts/0000-01-02-{{ user.username }}.md`と入力する。ファイル名の中に`/`を入れることで自動的にそのファイルを`_posts`ディレクトリに保存することが出来ます。 80 | 1. ファイルの名前を入力したら、以下の内容をファイルに追加する： 81 | ```yaml 82 | --- 83 | layout: slide 84 | title: "２枚目のスライドにようこそ！" 85 | --- 86 | 何かを書く。 87 | 戻るには戻るボタンを使いましょう！ 88 | ``` 89 | 1. テキストを追加後、ファイル編集ビューのすぐ下にあるテキスト入力フィールドにコミットメッセージを入れることで、この変更をコミットすることが出来ます。コミットメッセージのガイドラインとしては、手順のすぐ上にある**コミットの基礎**を参照してください。 90 | 1. コミットメッセージを入力したら、**Commit new file**をクリック 91 | {% endif %} 92 |
93 |

このブランチに新しいコミットが行われたら、追加のコメントを書き込みます。

94 | -------------------------------------------------------------------------------- /responses/ja/05_open-a-pr.md: -------------------------------------------------------------------------------- 1 | ## ステップ６：プルリクエストを作ろう 2 | 3 | コミットの作成に成功しました :sparkles: 4 | 5 | コミットの作成が完了したので、次にプルリクエストによって変更を提案してみましょう！イシューでは他のメンバーと議論をすることが行われますが、プルリクエストではあなたが行った変更を共有し、その変更についてのフィードバックをもらい、完璧になるまでそれを繰り返すのです！ 6 | 7 |
プルリクエストとはなにか？ 8 | 9 | ## プルリクエスト 10 | 11 | GitHubフローを思い返してみましょう。ブランチの作成をし、ファイルを追加し、ブランチにそのファイルをコミットしました。次にこのファイルについて他のメンバーとコラボレートしましょう。プルリクエスト上でコラボレーションを行います。詳細はこのビデオを御覧ください： 12 | 13 | :tv: [ビデオ：プルリクエストの紹介](https://youtu.be/kJr-PIfLDl4) 14 |
15 |
16 | 17 | このプルリクエストは、ブランチに対して行った変更を保持し、`main`ブランチへ取り込むためのものです。 18 | 19 | ### :keyboard: やってみよう：プルリクエストの作成 20 | 21 | 1. [このリンク]({{ url }})をクリックするか、下記手順によってプルリクエストを作成しましょう： 22 | - "Pull requests"タブから、**New pull request**をクリックしましょう 23 | - "base:"ドロップダウンメニューでは、"main"が選択されている事を確認しましょう 24 | - "compare:"ドロップダウンメニューでは、"{{ branch | remove: 'refs/heads/' }}"を選択しましょう 25 | - "Create pull request"ボタンを押しましょう 26 | 1. ブランチを選択したら、プルリクエストのタイトルを入力しましょう。例えば`{{ user.username }}のファイルを追加`などです。 27 | 1. 次のフィールドには、行った変更の説明を記載します。ここまでに行ってきたことについて、自由に記載しましょう。ちなみに、ここまででこれらの事をやってきています：ブランチの作成、新規ファイルの作成、コミットの追加、プルリクエストの作成 28 | 1. **Create pull request**をクリックしましょう 29 | 30 |
31 |

新しいプルリクエストが作成されたら、そこにコメントを書き込みます

32 | -------------------------------------------------------------------------------- /responses/ja/06_fix-base.md: -------------------------------------------------------------------------------- 1 | ベースブランチは`main`である必要があります。新しいプルリクエストを作成し、これを修正しましょう。 2 | 3 | ### :keyboard: やってみよう：プルリクエストのマージ先の修正 4 | 5 | 1. プルリクエストのタイトルの右側にある**Edit**ボタンをクリックしましょう 6 | 1. タイトルのコメントボックスの下の"base:"ドロップダウンメニューで"main"が選択されている事を確認しましょう 7 | 1. "base"を変更してよいかどうかを確認するポップアップウィンドウが表示されます。緑の**Change base**ボタンをクリックしましょう 8 | 9 | もしなにか問題に遭遇し、解決するのに助けが必要であれば、[GitHub Community]({{ communityBoard }})に書き込んでください。他の人が過去に解決した問題を検索することも出来ます。 10 | 11 |
12 |

このプルリクエストのベースが修正されたら、新しいコメントを書き込みます。

13 | -------------------------------------------------------------------------------- /responses/ja/06_fix-body.md: -------------------------------------------------------------------------------- 1 | 良いプルリクエストというものは、他のメンバーが見た時にどいうった変更をしようとしているのかを理解できるよう、本文に説明が書かれているものです。 2 | 3 | このプルリクエストに本文の説明を追加してみましょう。 4 | 5 | ## :keyboard: やってみよう：プルリクエストの修正 6 | 7 | 1. プルリクエストの最初のコメントはデフォルトのテキストである**No description provided**と書かれているでしょう。コメントボックスの右上にある **...** アイコンをクリックし、次に **Edit** をクリックして修正をしましょう 8 | 1. コメントボックスに変更についての説明を記載しましょう。ここまでに行ってきたことについて、自由に記載しましょう。ちなみに、ここまででこれらの事をやってきています：ブランチの作成、新規ファイルの作成、コミットの追加、プルリクエストの作成 9 | 1. コメントボックスの下の緑の **Update comment** ボタンをクリックしましょう 10 | 11 | 12 | もしなにか問題に遭遇し、解決するのに助けが必要であれば、[GitHub Community]({{ communityBoard }})に書き込んでください。他の人が過去に解決した問題を検索することも出来ます。 13 | 14 |
15 |

プルリクエストの本文が修正されたら、新しいコメントを書き込みます

16 | -------------------------------------------------------------------------------- /responses/ja/06_fix-filename.md: -------------------------------------------------------------------------------- 1 | ファイルは **{{ expected }}** という名前で作成する必要があります。 2 | 3 | これを解決するためにプルリクエストを編集してみましょう。 4 | 5 | ## :keyboard: やってみよう：プルリクエストの修正 6 | 7 | {% if preferences.gitTool == 'cli' %} 8 | 1. ブランチをチェックアウトします： 9 | ```shell 10 | git checkout {{ branch }} 11 | ``` 12 | 1. `ls` と入力し、ルートディレクトリの中を表示します。 13 | 1. `_posts` という名前のフォルダがある事を確認します。 14 | 1. `cd _posts` と実行してフォルダの中に移動します。 15 | 1. `_posts` フォルダの中を確かめるために `ls` と入力します。 16 | 1. `{{ expected }}` という名前のファイルがあることを確認します。 17 | 1. なにか修正が必要なものがあれば、その変更を行いステージ、コミット、プッシュを実行します： 18 | ```shell 19 | git add . 20 | git commit -m "" 21 | git push 22 | ``` 23 | {% else %} 24 | 1. プルリクエストの中の[Files Changedタブ]({{ url }})をクリックします。 25 | 1. 変更が行われたファイルが `{{ expected }}` というファイルであることを確認します。 26 | 1. もしそのファイル名が間違っていたり、正しい場所に無い場合は、画面右側の鉛筆アイコンをクリックし、ファイルを編集します。 27 | 1. ファイルの中身が表示されている部分の上のファイル名が含まれているテキストフィールドの内容を選択し削除します。 28 | 1. バックスペースキーを押し続け、ディレクトリ名も削除します。 29 | 1. 正しいファイル名を入力します： 30 | ```shell 31 | {{ expected }} 32 | ``` 33 | 1. 画面を下までスクロールし、**Commit Changes**にてコミットメッセージを入力してコミットします。 34 | {% endif %} 35 | 36 | もしなにか問題に遭遇し、解決するのに助けが必要であれば、[GitHub Community]({{ communityBoard }})に書き込んでください。他の人が過去に解決した問題を検索することも出来ます。 37 | 38 |
39 |

このブランチにコミットが行われたら、新しいコメントを書き込みます。

40 | -------------------------------------------------------------------------------- /responses/ja/06_request-changes.md: -------------------------------------------------------------------------------- 1 | ## ステップ７：レビュー対応をしよう 2 | 3 | 正しくプルリクエストが作成できました！ 4 | 5 | ファイルになにか追加してみましょう。ファイルの５行目をなにか新しい内容で置き換えてみましょう。忘れないでください：[Markdown](https://guides.github.com/features/mastering-markdown/)が使えます。 6 | 7 | ### :keyboard: やってみよう：ファイルの変更 8 | 9 | {% if preferences.gitTool == 'cli' %} 10 | 1. ブランチをチェックアウトします： 11 | ```shell 12 | git checkout {{ branch }} 13 | ``` 14 | 1. `_posts/0000-01-02-{{ user.username }}.md` を開きます。 15 | 1. ファイルの５行目をなにか新しい内容で置き換えます。 16 | 1. 新しい変更をステージします： 17 | ```shell 18 | git add _posts/0000-01-02-{{ user.username }}.md 19 | ``` 20 | 1. 変更をコミットします： 21 | ```shell 22 | git commit -m "" 23 | ``` 24 | 1. 変更をGitHubにプッシュします： 25 | ```shell 26 | git push 27 | ``` 28 | 29 | {% elsif preferences.gitTool == 'vscode' %} 30 | 1. `_posts/0000-01-02-{{ user.username }}.md`を開きます。 31 | 1. ファイルの５行目をなにか新しい内容で置き換えます。 32 | 1. 新しい変更をステージします。もう一度言いますが、Source Controlビューでファイルの横の **+** をクリックすることでステージすることができます。 33 | 1. 変更をコミットします。Source Controlビューでテキストフィールドにコミットメッセージを入力し、Windowsの場合はCtrl+Enter、macOSの場合はCommand ⌘+Enterと入力することでコミットすることができます。 34 | 1. 変更をGitHubにプッシュします。Source Controlビューで、...をクリックし、 **Push** を選択しましょう。 35 | 36 | {% else %} 37 | 1. このプルリクエストの[Files Changedタブ]({{ url }})をクリックします。 38 | 1. 画面右側の ... アイコンの中の "Edit file" をクリックし、新しく追加されたファイルを編集します。 39 | 1. ファイルの５行目をなにか新しい内容で置き換えます。 40 | 1. 画面の下にスクロールし、**Commit Changes** をクリックします。 41 | {% endif %} 42 | 43 |
44 |

このブランチへのコミットが行われたら、新しいコメントを書き込みます。

45 | -------------------------------------------------------------------------------- /responses/ja/07_pr-succeeds.md: -------------------------------------------------------------------------------- 1 | ## ステップ８：プルリクエストをマージしよう 2 | 3 | よく出来ました、@{{ user.username }}！ :sparkles: 4 | 5 | 無事にプルリクエストを作成し、全部のテストが成功しました。プルリクエストをマージする準備が出来ました。 6 | 7 | ### :keyboard: やってみよう：プルリクエストのマージ 8 | 9 | {% if preferences.gitTool == 'cli' %} 10 | 1. `main`ブランチをチェックアウトする： 11 | ```shell 12 | git checkout main 13 | ``` 14 | 2. ブランチをマージする： 15 | ```shell 16 | git merge {{ branch }} 17 | ``` 18 | 3. マージされた履歴をGitHubにプッシュする： 19 | ```shell 20 | git push 21 | ``` 22 | 4. ローカルブランチを削除する： 23 | ```shell 24 | git branch -d {{ branch }} 25 | ``` 26 | {% else %} 27 | 1. **Merge pull request**をクリックする 28 | 1. **Confirm merge**をクリックする 29 | {% endif %} 30 | 1. 一度ブランチがマージされたら、もはやそのブランチは必要ありません。**Delete branch**をクリックしましょう。 31 | 32 |
33 |

このプルリクエストがマージされたら、新しいコメントを書き込みます。

34 | -------------------------------------------------------------------------------- /responses/ja/08_reminder-delete.md: -------------------------------------------------------------------------------- 1 | ## よく出来ました 2 | 3 | ![celebrate](https://octodex.github.com/images/collabocats.jpg) 4 | 5 | おめでとう、@{{ user.username }}。このコースは完了です！ 6 | 7 | ## このコースでやったこと 8 | 9 | ここまでで、[ここ](https://{{ user.username }}.github.io/{{ repo }})にサイトをデプロイし、GitHub Flowを体験してきました。 10 | 11 | コースを完了する前に、このリポジトリで達成したタスクを振り返ってみましょう： 12 | 13 | - イシュー、プルリクエスト、GitHubリポジトリの構成について学びました。 14 | - ブランチについて学びました。 15 | - コミットを作成しました。 16 | - プルリクエストのレビューやレビューに対する返答をしました。 17 | - 既存のファイルを変更しました。 18 | - GitHub Pagesを有効化しました。 19 | - はじめてのコントリビュートを行いました！ :tada: 20 | 21 | ## 次のステップ 22 | 23 | このコースでGitHubに慣れてもらえると嬉しいです。忘れないでください、更に練習が必要だと思うのであれば、このコースを何度も繰り返し実行することができるのです。もっと新しいスキルを身に着けたいのであれば、いくつかおすすめがあります。 24 | 25 | ### プロジェクトにコントリビュートする 26 | 27 | コントリビュートする対象として、トレンドのトピックや厳選されたプロジェクトのコレクションを見つけたいのであれば、[GitHub Explore](https://github.com/explore)をチェックしてみましょう。 28 | 29 | ### 学び続けましょう 30 | 31 | 次に学ぶのにおすすめのコース： 32 | - [GitHub Pages]({{ host }}/githubtraining/github-pages)：このコースでも触れたGitHub Pagesについて更に学習することができます。 33 | - [Communicating using Markdown]({{ host }}/githubtraining/communicating-using-markdown)：このコースではMarkdownはほんの少しだけ使いましたが、Markdownの :sparkles: 記法を学びたいのであればこのコースを受講しましょう！ 34 | 35 | [次は何を学びましょう]({{ host }}/courses)? 36 | -------------------------------------------------------------------------------- /responses/ja/08_reopen.md: -------------------------------------------------------------------------------- 1 | ### :keyboard: やってみよう：プルリクエストのリオープン 2 | 3 | おおっっと！どうやら間違えてプルリクエストをクローズしてしまったようです。 4 | 5 | 1. **Reopen pull request**をクリックしましょう。もしこのボタンが押せないのであれば、先に**Restore branch**をクリックする必要があります。 6 | 1. プルリクエストをマージしましょう。 7 | 8 |
9 |

このプルリクエストがマージされたら、新しいコメントを書き込みます。

10 | -------------------------------------------------------------------------------- /server-installation-notes.md: -------------------------------------------------------------------------------- 1 | ## GitHub Enterprise Server (GHES) installation notes 2 | 3 | ✅ | This course is fully compatible with any supported version* of GHES. 4 | --- | --- 5 | 6 | *Supported versions of GHES are visible by using the drop-down in the [official documentation](https://help.github.com/enterprise/). 7 | 8 | ### Course dependencies 9 | 10 | The following are dependencies of the course. The course may continue to work without these dependencies, but learners won't experience the course as designed. 11 | 12 | | Dependency | Required? | Reason | Alternative | 13 | |--------------------------------------------------------------------------------------------------------------------------|-----------|--------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| 14 | | GHES must be able to reach githubusercontent.com | Yes | Images used throughout the course are served from this domain. Learners will find broken images required to take the course without this access. | Manually download the images referenced in the `responses/` folder, upload them to an accessible domain, and replace the images in the `responses/` folder. | 15 | | Learner must be able to reach github.com and outside web | No | Links are provided to resources that live on the outside web. | Without access to resources on the outside web, learners will reach blocked resources. You can change the links to these resources in the `responses/` folder, and in the template repository. | 16 | | [GitHub Pages](https://help.github.com/en/enterprise/2.16/admin/installation/configuring-github-pages-on-your-appliance) | No | Used to teach the learner simple deployments from their own repo. | Remove the step in `config.yml` that requires GitHub Pages is enabled. Look for references to GitHub Pages in the `responses/` folder and remove them. | 17 | --------------------------------------------------------------------------------