Skip to content

First Mission

Jump to bottom
Serkan Holat edited this page Jul 5, 2018 · 6 revisions

This is an experimental attempt to help you to get familiar with our project and make your first pull request.

We created a page on our website that lists our contributors.

Your mission dear potential contributor, should you choose to accept it, is to fork our project, update this html page by adding your name and some optional details and send it to us as a pull request.

After reviewing it, we will publish your changes to our website with the next update and your mission will be completed.

Before starting to this one, you need to complete Getting Started tutorial and make the project ready on your computer.
Getting Started

Please note that tutorials only cover Windows, Visual Studio and Github Desktop scenario at the moment.

If you wonder the reasoning behind this approach, please read our article on Medium.
First Mission: Contributors Page

Here are the steps for your first pull request (click on the images to enlarge them):

Step 1

  • 2/6) In Visual Studio open and update contributors.component.html file.
    • Open Edit - Navigate To... (Shortcut: Ctrl + ,) from the menu.
    • Type contributors.component.html into the box and open the file.
    • Copy sample tr block.
    • Paste it after [tr class="mat-header-row" role="row"]...[/tr] block below.
    • Edit this new row with your own details (*):
      • Your name & nickname
      • Expertise (Optional): What would be your main role in case you would like to contribute to an open source project? Coder, designer, tester, documentation, support, social media, other?
      • Skills (Optional): What would be your top skills (max 5)?
      • Experience (Optional): How many years of experience do you have in your area? Enter the year that you started working.
      • Contacts (Optional): Add your contact details, each item as a separate li element (max 5). Use Font Awesome for different icons.
      • Joined on: The date that you're making this contribution in day, month, year format with numeric values.
  • Click Save icon on the menu to save your changes.

* About these optional questions, we wanted to ask them to make this interaction little bit more rich and it's part of the experiment. Please feel free to answer or ignore them.

Step 2

Step 3

  • 4/6) Open and update CHANGELOG.md file.
  • Open Edit - Navigate To... (Shortcut: Ctrl + ,) from the menu.
  • Type CHANGELOG.md into the box and open the file.
  • Determine new version number:
    . See last version number in the file.
    . Increase the last number by one.
    For example: 0.1.5 becomes 0.1.6.
  • Add your changes in the following format:

**[New version number]**

* AngularClient - Contributors page - [Your github username]

Step 4

  • 5/6) In Github Desktop, Commit your changes and Sync.
  • Go to Changes tab.
  • Fill Summary textbox with new version number.
  • Click Commit to Master.
  • Click Sync.

Step 5

  • 6/6) Send your Pull Request
  • From top menu, click Branch - Create pull request, this will open Open a pull request page in your browser.
  • Click Create pull request, keep the commit message and click to Create pull request again.

Step 6

Hooray, you sent your first pull request!

After reviewing your changes, we will contact you back through your Pull Request page. As mentioned earlier, if everything is okay, they will be published to our website with the next update.

Hope you enjoyed our quick tutorial.

Please feel free to contact us for issues, suggestions or new missions.

Clone this wiki locally