Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

⭐️ README 를 개선해주실 분을 모집합니다 ⭐️ #45

Closed
codeisneverodd opened this issue Apr 26, 2022 · 5 comments
Closed

Comments

@codeisneverodd
Copy link
Owner

codeisneverodd commented Apr 26, 2022

본 레퍼지토리의 README 를 개선해주실 분을 모집합니다! (모집기간: 채택 시 종료)
리드미 완성본을 제출해주실 필요없이, 기본적인 틀을 제시하시면 대화를 통해 개선 해나갈 예정입니다!

🎁 기여 혜택

  1. README 최상단 Contributors에 이름 추가 및 개인 홍보자료(블로그 링크 등 원하는 링크)를 삽입해드립니다!

유입이 계속 늘어나고 있는 만큼, 자기 PR에 좋은 포인트가 될 수 있다고 생각합니다 😁

  1. 2022년 4월 26일 기준,지난 2주간 약 3000 View, 180 명의 Unique Visitor를 가지고 있는 레퍼지토리이며 꾸준히 성장 중인 README를 작성해보실 수 있습니다!

image

  1. 약소하지만 기프티콘을 드릴 예정입니다!

🔥 README 제안 방법

본 이슈에 생각하시는 README 양식을 답글로 달아주시면 됩니다!

⭐️ 요구사항

🪶 README 의 방향성(1번이 가장 중요한 항목입니다.)

  1. Star 를 클릭하도록 유도하여야합니다, 레퍼지토리의 성장을 위함입니다.
  2. Contributors 가 상단에 위치하여야합니다, 레퍼지토리의 성장을 위함입니다.
  3. 레퍼지토리에 처음 들어왔을 때, "검색을 통해 문제의 해답을 찾을 수 있다"라는 사실을 바로 인지할 수 있도록 하여야합니다.
  4. 새롭게 문제를 추가하실 분들을 위하여, 기여하시는 분이 커밋 컨벤션을 보고 작성 할 수 있도록 유도하여야합니다.

🪶 추가로 고려하실 사항

  1. 문제 표는 자동완성으로 만들어지기 때문에 /// 문제 표 /// 와 같은 형식으로 채워두시면 됩니다.
@le2sky
Copy link
Contributor

le2sky commented Apr 26, 2022

@codeisneverodd
완전한 개선사항은 아니지만 없는 문제를 골라서 푸려고 하는 사용자가 있을 수도 있으니
아직 풀리지 않은 문제도 README에 작성되어 있으면 속도감있게 풀리지 않을까 기대합니다!

  • 추가로 해설이나 접근방법에 대한 내용을 따로 작성하는 파일이 있다면 CICD 구축해서 정적 사이트 배포도 불가능하지는
    않을 것 같습니다!

@codeisneverodd
Copy link
Owner Author

@le2sky 좋은 의견 감사합니다!!

  1. 풀리지 않은 문제를 자동으로 추가하고 그것을 명시할 방안을 고안해보겠습니다. 👍
  2. 풀이 외에 해설 부분을 별도의 파일로 유지하는 방안을 팀원들과 상의후 효과적이다 판단되면 적용하겠습니다 😁
  3. 정적사이트 배포는 다행히 예정되어있습니다!! 현재는 데이터 수집 및 사이트 설계 단계를 진행하고 있습니다 😆

@cruelladevil
Copy link
Contributor

cruelladevil commented Apr 27, 2022

@codeisneverodd

  1. 풀리지 않은 문제는 한 번만 추가하면 됩니다. 그 이후 풀린 문제와 풀리지 않은 문제를 구분하는 것에 의의를 두어야 할 것 같습니다.
    ex)
    ✅ | 풀린 문제
    ❌ | 풀리지 않은 문제

@codeisneverodd
Copy link
Owner Author

@cruelladevil 남겨주신 내용이 잘 이해가 안되었는데, 한 번만 추가하면 된다는 것이 적혀있는 풀이는 없더라도 해당하는 파일을 만들어야한다는 것 일까요?

@cruelladevil
Copy link
Contributor

@codeisneverodd
README.md에 전체 문제 목록을 한 번만 업데이트 하면 된다는 뜻입니다.
그 이후 풀이 파일이 있는 것과 없는 것을 비교해 풀이 여부를 결정하여 표시할 수 있습니다.
다만, 현재 README.md를 업데이트 하는 코드로는 level 구별이 안 되어있기 때문에 전체 문제를 README.md에 바로 업데이트 하지는 못하고 새로 코드를 만들어서 level 구분을 해서 넣는 작업을 한 번 하면 될 것 같습니다.
또한, 후에 프로그래머스에 새로운 문제들이 추가됨에 따라 문제들을 업데이트 해주는 것에 있어 일정 기간마다 체크하도록 ci를 작성하는 것도 좋아보입니다.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

3 participants