awesomelist.md

Keyword

awesome list github

Memo

• Git 을 익히게 되면 Git 기술 자체도 재미있지만 편하게 다루면서 오픈소스의 너른 세계를 탐험할 수 있는게 참 좋다. (ver.2021.07.20)
• 그리고 Git 온라인 강의를 만들었다. 그동안 초보자들에게, 그리고 협업을 할 때 부담을 느끼는 개발자들에게 강의와 세미나를 하면서 내용들을 담았다.
  • 링크는 여기 https://spartacodingclub.kr/online/drill_git
  • Git 의 기본 사용법, 협업에서 주의해야하는 것들은 무엇인지, Github 을 어떻게 social 하게 쓸 수 있는지
  • 처음 Git 을 접하는 사람들도 부담없이 사용할 수 있게 터미널 사용 등은 일부러 제외하고 GUI 툴을 사용한다. 처음에는 history, branch 를 볼 때 GUI 로 보는 게 조금 더 잘 보이니까
  • Git 의 사용법에 대해 다룬 책들은 많지만, 어떻게 git을 활용해서 오픈소스 세상 속으로 나아갈 수 있는지 사심을 담아 넣었다.
  • 3주차로 되어있지만 실제 강의시간은 그렇게 길지 않고. 오픈소스 이야기할 때 너무 신나서 강의 시간이 길어져서 덜어내느라 고생.
  • 마지막 여담으로 후속 강의를 생각하고 터미널이나 tool 에서 사용법, 조금 더 geek한 git 의 구조는 제외했는데 후속강의... 언제 만들지.

(ver.2018년) 상황 / 궁금증

• 콘텐츠를 스스로 찾아 학습하면서 삽질과 삽질을 거쳐 정리한 리스트로 현재는 입문에 초점이 맞추어져 있다.
• 사이드프로젝트를 함께 하는 사람들(github과 버전관리에 익숙하지 않음) 과 협업을 위해 정리해 둔 리스트 추가함
• 처음 학습을 시작할때만 해도 주위에 Github을 사용하는 사람이 없어서 스스로 찾아서 학습해야하는 상황이었다. 현업에서 사용하지 않았기 때문에 학습비용이 아깝지 않게 적용했을때 어떤 시너지가 나는지, 어떤 것이 강점인지를 찾는게 필요했다. 또 실제 현업에서는 어떤. 기능을 많이 쓰고 적용하는지와 함께 흥미를 잃지 않도록 적용 난이도를 낮출 수 있는 방법을 찾아야했다.  

정리

• 👍로 당장 git을 써서 협업해야하는 상황일때, 우선적으로 읽고 빠르게 적용하기 위한 콘텐츠를 구분해두었음

About Git/ Github

입문

• 책 - 인간다운 Git (Git For Humans) / 책소개한 블로그 : 누가 git이 뭐야? 써보고 싶어. 라고 나에게 물어본다면 이 책 추천. 전반적으로 git에서 많이 쓰이는 내용과 함께 git에 있는 미묘한 개념, 협업부분에 대해 설명. 문고판 크기로 80장 정도 되어 읽기 부담스럽지 않음. git add 한 다음에 git commit 해야하는 건 알겠는데 왜 바로 커밋안하고 staging(git add)하는지에 대한 걸 알고 싶다면, 바로 이 책이다.
• Github Guides 👍 : 짧게 짧게 읽으면서 감 잡기에 좋음. 아티클 읽는 시간은 10분 내외임
• Git-flight-rules +1: 이런 상황에는 이런 git commad를 사용하면 된다를 짧게
• 10 Git Commands You Should Know : 여기 있는 것만 알아도 어느정도는 편하게 쓸 수 있다. 어느정도는.
• try Git - exersise
• git - the simple guide 👍
• git/github 기초강의- 코드스쿼드
• 누구나 쉽게 이해할 수 있는 git 입문
• Git을 이용하여 텔레파시 통하는 팀 만들기 : commit message와 commit log - 해줌스토리 👍
• How to Write a Git Commit Message
• 만들면서 배우는 Git+GitHub 입문 / 도서📚 : 제목에 충실한 책. 모르는 게 너무 많아서 시도해볼 엄두가 안날때 두려움을 떨쳐내는데 도움이 많이 되었음
• 바쁜 팀장님 대신 알려주는 신입 PHP 개발자 안내서 / 도서📚 : 왜 Git을 사용해야하는가?에 대해 친절하게 나와있음. 나는 php개발자가 아닌데도 배움의 우선순위를 파악할 수 있어서 좋았다. 뭐가 중요한지 목차를 보면 됨.

Action 배웠다면 일단 시도해봅시다! 👍

• [GitHub] GitHub로 협업하는 방법[1] : 주위에 친구 몇 명만 모집해서 이 방식으로 프로젝트를 해보는 건 어떨까? 내용없이 git사용법만을 익히기 위한 프로젝트라도 괜찮을 거 같음. 난 처음엔 git이 궁금해서 일단 코드없이 프로젝트 기록이나 자료링크를 모아두는 마크다운으로만 이루어진 프로젝트를 만들었고, 부담없이 재밌게 배울 수 있었음
• 깃허브(GitHub)로 취업하기 by Sujin Lee : 구직목적이 아니더라도 Github 활동에 대해 깔끔하게 정리되어 있음
• Code For Women 첫 세미나 - 일일커밋 후기 by Joeun Park
• first contribution
• FIRST TIMERS ONLY - Friendly Open Source projects should reserve specific issues for newbies

주요 레퍼런스

• ebook - pro Git book / ebook - pro Git book(한국어)
  • 내용이 너무 많아서 입문할때는 읽어볼 엄두가 안났었는데, 좀 두려움이 가시고 나니 이것만한 콘텐츠가. 없다.  - 내 경우, 자주 쓰이는 명령어를 익힌 상태라서, 이후 Git 학습은 '모르는 부분 검색 -> 관련 키워드 찾음 -> 위 아티클에서 찾아서 컨텐스트 파악'의 프로세스로 진행하고 있다. 영문판 한글판 두 개를 동시에 보고 있음. 개념을 빠르게 이해하기 위해 한글판을 먼저 보고, 구글링을 위해 한글화되지 않은 용어를 확인용으로 영문판을 봄. 가끔 어색한 한글번역이 있어서 1판도 참고함.
  • git 명령어 단순암기를 넘어서 어떻게 동작하는지 궁금하다면 10.Git의 내부를 추천. 나는 읽은 내용을 Git 내부 에서 정리하고 있다. 틈틈이 읽으며 정리하고 있음
• git- docs : git --version으로 사용하고 있는 version에 맞는 doc 확인
• Github Help : github 사용하면서 발생하는 여러 상황에서 바로 적용할 수 있도록 Help 문서 제공
• Gitlab Help : Git을 프로젝트에 어떻게 적용해볼 수 있을지 힌트가 되는 문서들이 있음. 현재 사용하고 있는 Gitlab 버전을 잘 확인해야함. 기능 제공되는줄 알고 설레었다가 회사 Gitlab 버전이 낮아서 시무룩해진 적이 몇 번 있음.

프로젝트 관리 관점 - 어떻게 적용할 것인가?

• 아래 레퍼런스를 참고하여, 다른 팀원들이 적용할 수 있도록 회사 프로젝트에서 Git 기본 사용 가이드를 작성하였다.

협업

• SLiPP 테스트기반개발 스터디 wiki - SW 개발 업무 Cycle 👍 : 스터디를 하면서 현업에서는 어떻게 진행하고 있는지 감 잡는데 많은 도움이 되었다. / 여기서 배운 것과 온라인 코드리뷰 강의를 들으면서 정리한 내용은 코드리뷰에 업데이트하고 있다.
• GitHub Flow explain by Sung Kim 📺/ 동영상 👍
• GitHub Flow demo 📺/ 동영상 👍
• 협업flow 간단한 설명 (Git 익숙하지 않는 프로젝트 팀원용 초간단 tutorial)
  • git을 사용한 프로젝트관리 flow에는 GitFlow, GithubFlow, GitlabFlow가 있음.
  • 크게 Issue 등록 - Branch - commit - PR - codeReview - Merge 단계를 거침
  • 작업단위 외에 고쳐야할 버그는 issue 먼저 작성 (Assignee, Milestone 지정)
    • 해당하는 Milestone이 없을 경우, 팀멤버와 이야기 한 후 설정
  • 각각 본 레포지토리 fork 후 로컬에서 작업단위로 Branch 나누어 commit
  • 이후 pull Request
  • codereview 후 merge
• Github로 프로젝트 관리하기 by cheese10yun : GitHub을 활용한 기본적인 프로젝트 관리방법을 익힐 수 있음. 처음 시작할때 놓치기 쉬운 부분을 짚어줌.
• 팀을 위한 Git - Git 워크플로우를 효율적으로 만드는 사용자 중심 접근법 / 도서 : 협업관점에서 어떻게 git을 사용할 것인지 고민되어서 읽는 중. 아웃사이더 - Book 팀을 위한 Git님의 서평 참고

Version 명세

• 유의적 버전 명세

codereview / contribution

• 텍스트와 이미지로 살펴보는 코드스쿼드의 온라인 코드 리뷰 과정 👍
• GITHUB와 함께 Social하게 코딩하기 by Young-Ho Cha
• Github를 기반으로 한 온라인 코드리뷰 방법 / 동영상 📺 👍
• Naver 오픈소스 가이드
• commit-together-with-co-authors

Issue

• github guide - issue
• 내 집 관리도 github issue 관리로! Issue tracker for my house
• github - issue/PR template

PR

• How to test Pull Request?
• Checkout github pull requests locally
• GitHub의 Merge, Squash and Merge, Rebase and Merge 정확히 이해하기 : PR을 반영할때 적절한 방식을 찾기. 내 사이드 프로젝트에서는 PR 단위를 먼저 정의하고 들어가기 때문에, log를 빨리 파악할 수 있도록 주로 sqash and Merge하는 편이다

Branch

• Branch명 : 영어,동사-(작업파일 또는 단위)
  • stackoverflow-git-branch-naming-best-practices
  • Git Branch - 릴리즈 플래닝 - 회사에서 하고 있는 걸 정리해본다
  • e.g. refactor-authentication, user-content-cache-key, make-retina-avatars
  • 참고.Understanding the GitHub Flow
• commit Log : 영어로 목적어 + 동사
  • 참고: How to Write a Git Commit Message
  • Git Commit Good Practice

그외 팁 / 기타

• sourcetree : 널리 쓰이는 git client tool. CLI 대신 GUI를 통해 git을 사용해보고 싶다면 추천. 널리 쓰이기 때문에 사용방법과 오류메시지를 인터넷에서 찾기 쉬움.
• Fork - 가벼운 git client tool : 많은 사람들이 사용하는 sourcetree보다 좀 더 가벼운 느낌. 해당 tool을 사용하면서 불편함은 없고 UI를 사용하기 편했지만 한국어 지원이 되지 않는다는 점을 참고.
• Git 팁 모음집 (https://github.com/git-tips/tips 한국어 버전)
• Removing sensitive data from a repository
• Squash your commits
• MarkDown cheetsheet
• Git - submodule
  • Git: 서브모듈 이해하기 (git submodule)- by ohgyun
  • sparse checkout
    • git-commit-push-pull-with-sparse-checkout