👷🏽‍♂️ Gato GraphQL 공개 개발 일지 #1 (2021년 3월)

「Building in the Open」 뉴스레터의 기념비적인 첫 번째 호에 오신 것을 환영합니다!

이 채널은 Gato GraphQL 개발에 관한 소식을 커뮤니티와 공유하기 위한 것으로, 매월 첫 번째 주에 발송됩니다.

이 공간을 통해 지난 한 달 동안 일어난 모든 일을 알려드리겠습니다. 내용은 다음과 같습니다:

✅ 진행해 온 작업, 출시한 새 기능
✅ 다음 달에 진행할 예정인 작업
✅ 사이트에 유입된 트래픽 양
✅ 플러그인 현황: 다운로드 수, 뉴스레터 구독자 수, GitHub 스타 수
✅ 재정적 지속 가능성을 향한 진척
✅ 새로 공개된 가이드
✅ 최근 게시된 블로그 게시물 요약
✅ 아웃리치 / 플러그인 언급
✅ 일반 소식

이 뉴스레터가 마음에 드신다면, 친구분들께도 구독을 권해 주세요.

시작하겠습니다!

안내: 이 뉴스레터는 양방향 소통 채널입니다. 하고 싶은 말씀이 있으시면 언제든지 댓글을 추가해 주세요 (블로그 게시물 하단에 있습니다).

​

코딩 작업 내용

가이드를 보시면 「Extending Gato GraphQL」 섹션이 아직 많이 비어 있습니다:

저의 우선 과제는 이 가이드들을 완성하는 것입니다. 하지만 그에 앞서 플러그인 코드를 최대한 간결하게 만들고 싶습니다. 코드가 간결할수록 필요한 문서가 줄어들고, 더 많은 사람들이 이해할 수 있게 됩니다.

이런 생각을 바탕으로 Symfony의 DependencyInjection 컴포넌트를 완전히 기반으로 하도록 코드를 리팩터링하기로 결정했습니다.

핵심 아이디어는 플러그인에 대한 확장(커스텀 TypeResolver, FieldResolver, DirectiveResolver 등)을 컨테이너의 서비스로 정의하기만 하면, 컴파일러 패스를 통해 서비스가 자동으로 구성된다는 것입니다.

Symfony의 의존성 주입에 완전히 의존하면 몇 가지 장점이 있습니다:

✅ 확장 기능을 만드는 일관된 단일 방법이 존재합니다
✅ 특정 인터페이스를 구현하는 PHP 클래스를 만들기만 하면 모든 작업이 완료되므로, 개발자가 세부 사항을 파악할 필요가 없습니다
✅ Symfony의 문서는 매우 방대합니다. 개발자를 그쪽으로 안내함으로써, 제가 작성할 필요가 없는 문서가 됩니다

코드가 궁금하신가요? 최근 병합된 PR들을 확인해 보세요 (#453, #452, #449 및 기타 여러 개).

마이그레이션이 100% 완료되어 누락된 가이드를 작성할 수 있을 때까지 앞으로 몇 주간 이 코드 작업을 계속할 것입니다.

​

gatographql.com 트래픽

한 가지 분명히 말씀드리고 싶은 것이 있습니다: 플러그인 웹사이트를 방문하는 사람의 수는, 얼마나 많은 사람들이 플러그인을 알고 있는지 파악하기 위한 대리 지표로서 저에게 중요합니다.

플러그인을 홍보할 충분한 자금이 없습니다. 설령 있다 하더라도, 오픈 소스의 정신에 반하기 때문에 홍보에 돈을 쓰지 않을 것입니다. (오픈 소스가 단순히 어떤 제품이나 서비스를 파는 채널에 불과하다면 이야기가 다르겠지만, 저의 경우는 그렇지 않습니다.)

즉, 홍보는 전적으로 입소문에 의존하고 있습니다. 이를 위해 플러그인의 블로그에 고품질 콘텐츠를 작성하는 데 많은 노력을 기울여 왔으며, 이 콘텐츠가 널리 퍼져서 그렇지 않으면 플러그인을 몰랐을 사람들에게 닿기를 바랍니다.

그리고 지금까지의 결과에는 꽤 만족하고 있습니다.

지난 달에는 4,500명의 방문자와 6,000 페이지 뷰를 기록했습니다:

이 통계를 자세히 살펴보겠습니다.

방문자의 대부분은 몇 개의 「Show HN」 프런트 페이지에 오를 수 있었던 Hacker News에서 옵니다. 또한 Reddit에서도 방문자가 오는데, 주로 /r/PHP와 /r/graphql에서입니다 (항상 글을 공유하는 곳입니다).

「wordpress core graphql」 검색 시 Google 1위를 달성하여 많은 트래픽을 가져왔습니다. 아쉽게도 그것은 단 한 번뿐이었습니다: 24시간 후, 갑자기 나타난 것처럼 갑자기 사라졌습니다. 그 외 일반적인 날에는 Google에서 3~10명의 방문자가 옵니다.

Twitter와 Facebook은 상당한 트래픽을 가져오지만, 누구에게서인지는 알 수 없습니다 (저는 아닙니다. 소셜 미디어를 극도로 잘 못하기 때문에). Twitter에는 글을 공유하지만 리트윗되는 경우는 거의 없습니다. 그리고 👎🏾 Facebook은 사용하지 않습니다.

(참고로, 소셜 미디어에서 제 글을 공유해 주시는 분들, 감사합니다 ❤️)

graphql.org의 PHP GraphQL 서버 목록과 dev.to에 게재한 글 (「graphql execute multiple queries」로 Google 검색 시 1위)에서 소박하지만 꾸준한 트래픽을 얻고 있습니다.

마지막으로, 제 글은 WordPress의 주요 뉴스레터(WP Owls, wpMail.me, Post Status, WP Builds, The WP Weekly 등)에 꾸준히 게재됩니다. 각 뉴스레터가 얼마나 많은 트래픽을 가져오는지는 정확히 알 수 없습니다. 참조 출처가 Gmail 등 다른 서비스로 표시되기 때문입니다. 하지만 합산해서 보면, 이 뉴스레터들은 상당한 수의 방문자를 만들어냅니다.

블로그 게시물이 단연 가장 인기 있는 콘텐츠로, 최근 3개의 글(이 글, 이 글, 이 글)이 각각 1,000명 이상의 방문자를 기록했습니다.

이 수치들은 꽤 좋아 보입니다. 웹사이트를 시작한 지 2개월도 채 되지 않은 점을 감안하면 더욱 그렇습니다. 하지만 모든 것이 좋은 것은 아닙니다: 이탈률이 88%로 매우 높습니다. 이 부분은 개선이 필요합니다.

​

지표

사이트 트래픽은 플러그인 인지도를 추정하기 위한 장식적인 지표에 불과합니다. 하지만 더 중요한 질문은 지난 달 동안 실제로 플러그인을 사용하기 시작한 사람이 몇 명인가 하는 것입니다.

지난 달 플러그인의 실적은 다음과 같습니다:

🎯 플러그인 다운로드 수: 170
⭐️ GitHub 스타 수: 27

다운로드 수는 GitHub API에서 가져올 수 있습니다. 지난 달에 생성된 릴리스 3개만 포함하기 위해 per_page=3 파라미터를 전달합니다:

curl -H "Accept: application/vnd.github.v3+json" https://api.github.com/repos/GatoGraphQL/GatoGraphQL/releases?per_page=3 | grep "download_count"Copy

이 수치들에 대해 기쁘지도 불만스럽지도 않습니다. 훌륭하지는 않지만 (더 좋았으면 하는 마음은 있지만), 좋은 시작점입니다.

다운로드 수와 관련하여, 첫 번째 사용자를 얻는 것이 가장 어려운 과제라고 합니다. 몇 사람이 플러그인을 사용하기 시작하고 그에 대해 이야기하기 시작해야만 사용이 더 널리 퍼집니다. 저는 아직 헌신적인 첫 번째 사용자들을 찾는 초기 단계에 있습니다.

GitHub 스타 수에 대해서는, 꽤 평탄해 보인다고 말씀드릴 수밖에 없습니다: 평균 하루에 약 1개의 스타입니다. 이것은 결코 훌륭한 것이 아닙니다. Gato GraphQL로 구축하고 있는 것이 마음에 드시고 ❤️ 애정을 보여주시는 것을 꺼리지 않으신다면, GitHub에서 ⭐️ 스타 주는 것을 고려해 주세요.

​

재정적 지속 가능성

이것이 어려운 문제입니다: 프로젝트는 재정적으로 지속 가능해야 합니다. 약간의 수익을 창출하거나, 그렇지 않으면 오래 지속되지 못할 것입니다.

제 자신의 수입을 얻을 수 있다면, 필요한 한 계속 작업할 수 있습니다. 그것이 제게 필요한 전부입니다: 수입. 수백만 달러를 요구하는 투자자가 문을 두드리는 것이 아닙니다. 단지 집세를 낼 수 있는 월 수천 달러면 됩니다.

플러그인을 완전한 오픈 소스로 유지하는 것이 목표입니다. 이를 위해 현재 몇몇 잠재적 스폰서에게 연락하여 플러그인 개발 자금을 지원할 의향이 있는지 묻고 있습니다. 양측 모두에게 이득이 되는 상황이 될 것입니다.

커뮤니티의 누구에게서나 받을 수 있는 일반적인 스폰서십에 의존하는 대신, 왜 「큰 손」 스폰서에게 의존하려고 하는 걸까요?

네, 그것도 시도하고 있습니다: GitHub Sponsors에 등록되어 있습니다. 하지만 이미 수천 명의 사용자, 팔로워, 또는 메일링 리스트 구독자가 있어서 그들에게 연락하여 많은 지원을 기대할 수 있는 상황이 아니라면 실제로는 잘 작동하지 않습니다.

예를 들어, 월 표준 5~10달러를 요청한다면, 이 방식으로 제 작업을 충당하려면 수백 명의 후원자가 필요합니다. 그리고 저는 그 단계와는 거리가 멉니다.

하지만 더 나아가서, 이 방식으로 정말로 성공할 수 있는 사람이 있을까요? Caleb Porzio (Livewire 제작자)는 성공을 거두었고, 현재 1,350명 이상의 스폰서를 보유하고 있습니다! 하지만 그것은 예외이지 표준이 아닙니다.

예를 들어 Composer를 보십시오. Composer는 PHP 애플리케이션 개발 방식을 근본적으로 바꾸었지만, 스폰서가 겨우 90명 정도에 불과합니다. 어떻게 Composer보다 더 많은 스폰서를 얻을 수 있다고 기대할 수 있겠습니까?

그렇기 때문에 제 현재 접근 방식은 저의 프로젝트와 스폰서를 원하는 소수의 기업 모두에게 이득이 되는 상황을 만드는 것입니다. 잘 될 것을 바랍니다. Gato GraphQL이 모든 사람에게 무료로, 모든 기능을 사용할 수 있고, 좋은 기능을 유료 장벽 뒤에 숨길 필요가 없기를 바랍니다.

(어떻게 양측 모두에게 이득이 되는지 알고 싶으시다면, 이메일을 보내주세요 또는 DM을 보내주세요. 귀하의 회사도 관심이 있을 수 있습니다.)

이 접근 방식에 몇 달의 시간을 드리겠습니다. 성공하기를 바랍니다. 성공하지 못할 경우에만 플러그인의 PRO 버전을 개발하고 일부 기능을 유료 버전으로 제한하는 것을 고려해야 할 것입니다. (그렇게 되면 안타까울 것이므로, 그 단계를 피할 수 있기를 바랍니다.)

다음 뉴스레터에서 스폰서를 확보했는지 여부를 알려드리겠습니다.

​

블로그 게시물

블로그 게시물은 저의 절대적인 자부심이자 기쁨입니다.

안내: 사이트에 RSS 피드가 있다는 것을 알고 계셨나요? 모든 블로그 게시물을 받아보도록 구독하고, 좋아하는 리더에서 읽으실 수 있습니다.

지난 달에는 매주 고품질 블로그 게시물을 하나씩 게시할 수 있었습니다:

🛠 WordPress는 코어에 GraphQL API를 가져야 할까요?에서는 WP REST API가 WordPress 5.6에서 새 기능(배치 작업)을 얻었기 때문에, GraphQL API가 기본적으로 제공할 수 있으므로 WordPress가 GraphQL로부터 혜택을 받을 수 있다는 주장을 펼칩니다.

🥊 Gato GraphQL vs WPGraphQL: 대결!에서는 제 플러그인과 WPGraphQL을 비교하며, 오랫동안 기억될 대결로 복싱 팬들이 더 많은 것을 원하게 만들 것입니다.

👶🏻 GraphQL로 WordPress 젊어지게 하기에서는 헤드리스 WordPress를 WordPress 코드베이스에서 분리하는 방법을 시연하며, 축적된 기술 부채를 수정하거나 (적어도 우회할) 기회를 제공한다는 것을 보여줍니다.

🍾 Gato GraphQL이 PHP-Scoper 덕분에 스코프되었습니다!에서는 다른 플러그인과의 충돌을 피하기 위해 PHP-Scoper를 사용하여 WordPress 플러그인을 스코프하는 전략을 설명합니다.

​

아웃리치 / 플러그인 언급

플러그인이 몇 곳에서 소개된 것을 매우 기쁘게 생각합니다.

✅ WordCamp India 2021에서 「Intro to Gato GraphQL」 강연을 하며 플러그인 데모를 진행했습니다. (데모임에도 불구하고 놀랍게도) 모든 것이 완벽하게 진행되었습니다! YouTube 동영상을 확인해 보세요.

✅ Joe Howard가 WPMRR 팟캐스트를 위해 저를 인터뷰했습니다. 녹음은 곧 공개될 예정입니다.

✅ Chris Coyier가 CSS-Tricks 뉴스레터 #239에서 제 플러그인을 소개했습니다!

​

이것저것

지난 한 달 동안 일어난 다양한 일들에 대한 일반 소식입니다.

​

Jason Bahl의 WP Engine 합류

Jason이 WP Engine에 합류한 것을 축하합니다! WPGraphQL에서 지금까지 해온 것처럼 앞으로도 계속 활약해 주시기를 바랍니다.

참고로, 우리가 경쟁 관계라는 사실 (뭐, 제가 그와 경쟁하는 것이지만, 그는 훨씬 앞서 있습니다)이 친구가 될 수 없다거나 서로의 프로젝트를 개선하기 위해 협력할 수 없다는 것을 의미하지는 않습니다. 실제로 우리는 같은 목표를 공유합니다: GraphQL을 WordPress에 가져오는 것 (그것이 어떻게 실현되어야 하는지에 대해서는 다른 생각을 가지고 있지만).

하지만 저는 경쟁이 좋다고 생각하며, 모두에게 유익할 것이라고 믿습니다.

​

WP Engine의 Atlas 출시와 헤드리스에 대해 모든 것을 안다는 주장 (정말로?)

WP Engine이 새로운 헤드리스 WordPress 솔루션인 Atlas를 출시한 것도 축하드립니다.

안타깝게도, 부정확한 정보를 기술하고 있습니다:

완전히 헤드리스 솔루션을 사용하는 기업들은 일반적으로 프런트엔드용 별도의 JavaScript 애플리케이션을 호스팅하며, API(WordPress REST API 또는 WPGraphQL 플러그인)를 통해 특정 WordPress 데이터를 가져옵니다.

그렇군요, Gato GraphQL은 존재하지 않는 거죠?

저는 보통 이것을 신경 쓰지 않습니다. 모든 사람이 제 플러그인을 알고 있다고 기대하지 않기 때문입니다. 하지만 그들은 제 프로젝트를 알고 있다고 생각하며, 의도적으로 무시하는 것 같습니다.

그들이 developers.wpengine.com («헤드리스 WordPress를 위한 모범 사례, 튜토리얼, 블로그, 문서의 원스톱 허브»)을 출시한 후, 저는 그들에게 연락했습니다:

• WP Engine의 헤드리스 WordPress 담당 개발자 관계 Matt Landers, Twitter에서
• 개발팀, 그들의 헤드리스 프레임워크 GitHub 저장소에서
• Torque (WP Engine이 소유한 잡지)의 누군가, @TheTorqueMag에 DM으로

아마도 그들은 제 프로젝트를 진지하게 받아들이지 않은 것 같습니다. 아니면 WPGraphQL에 완전히 투자되어 있어서 단순히 신경 쓰지 않았을 수도 있습니다.

제 플러그인을 언급하고 싶지 않다면, 그것은 그것대로 괜찮습니다. 하지만 WP REST API와 WPGraphQL이 유일한 두 가지 선택지라고 말하는 것은 매우 오해를 불러일으킵니다. 그 결과, 제 플러그인이 피해를 입고 개발자 커뮤니티가 혼란을 겪습니다.

그러니 네, 솔직히 말해서 저는 화가 납니다. 이것은 전혀 좋지 않습니다. 그들이 부정확한 정보를 수정해 주기를 바랍니다 (이미 이메일을 보냈습니다).

​

마무리

이것이 첫 번째 「Building Gato GraphQL in the Open」의 끝입니다.

어떠셨나요? 댓글로 생각을 공유해 주시면 감사하겠습니다.

마음에 드셨다면, 친구들과 뉴스레터를 공유해 주시면 감사하겠습니다 (혹은 더 좋은 것은, 구독을 권해 주세요).

다음 달에 뵙겠습니다!