Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Rust 블로그 가이드라인

배경

Rust 프로젝트는 두 개의 블로그를 운영합니다. “메인 블로그”(blog.rust-lang.org)와 “inside Rust 블로그”(blog.rust-lang.org/inside-rust)입니다. 이 문서는 각 블로그에 글을 쓰려면 무엇이 필요한지에 대한 가이드라인과 함께, 글을 제안하는 방법 및 가장 적합한 블로그를 고르는 방법을 안내합니다.

알맞은 블로그를 선택하는 방법: 독자

Rust 블로그 게시물을 작성하려는데, 어느 블로그에 게시해야 할지 알고 싶으실 것입니다. 결국 선택지는 세 가지입니다.

  • 메인 Rust 블로그
    • 독자가 “모든 Rust 사용자 또는 잠재적 사용자”일 때 적합합니다
    • 개인이 서명하더라도 “공식 입장”에서 작성됩니다
  • inside Rust 블로그
    • 독자가 “모든 Rust 기여자 또는 잠재적 기여자”일 때 적합합니다
    • 개인이 서명하더라도 “공식 입장”에서 작성됩니다
  • 여러분의 개인 블로그
    • 그 밖의 모든 경우

이 중 어느 것이 적합한지 결정하려면 두 가지 핵심 질문에 답해야 합니다.

  • “공식적인 자격”으로 말하고 있습니까, 아니면 “개인”으로서 말하고 있습니까?
  • 글의 독자는 누구입니까?

일반적으로 “개인”으로서 말하는 경우라면 여러분의 개인 블로그에 쓰는 것이 가장 좋을 것입니다.

반면 공식적인 자격으로 글을 쓴다면 Rust 블로그 중 하나가 적합할 것입니다. 그렇다고 해서 개인으로서 글을 쓸 수 없다는 뜻은 아니라는 점에 유의하십시오. Rust 블로그의 많은 글은 개인 명의로 서명되어 있으며, 실제로 그 방식이 선호됩니다. 다만 그런 글은 대개 팀의 공식 입장을 기록하는 글입니다. 좋은 예로 Rust의 언어 인체공학 이니셔티브에 관해 Aaron Turon이 쓴 고전적인 글이 있습니다. 때로는 흥미로운 프로젝트를 소개하는 글도 있지만, 이 역시 프로젝트 전체를 대표하는 방식으로 작성됩니다(예: Firefox Quantum의 두려움 없는 동시성에 관한 Manish Goregaokar의 보고).

메인 블로그와 inside Rust 블로그 중 하나를 고르려면 글의 독자가 누구인지 스스로 물어보십시오. 메인 블로그의 글은 모든 Rust 사용자 또는 잠재적 사용자를 대상으로 해야 합니다. 이런 글은 기술적 세부 사항을 비교적 가볍게 다루고, 많은 배경지식 없이도 읽을 수 있게 작성되는 경향이 있습니다. inside Rust 블로그의 글은 훨씬 더 많은 배경지식과 Rust에 대한 친숙함을 전제할 수 있습니다.

메인 Rust 블로그에 글쓰기

메인 Rust 블로그에 무엇을 게시할지는 최종적으로 리더십 위원회가 결정합니다.

Rust 조직 내부의 흥미로운 진전을 소개하는 글 제안과 Rust의 흥미로운 활용 사례를 소개하는 글 모두 환영합니다. 다만 일반적으로 다른 프로젝트와의 “홍보성 교차 게시”는 하지 않습니다.

릴리스 노트 블로그 게시물

특별한 경우로, 모든 Rust 릴리스와 함께 나오는 정기 릴리스 노트 게시물이 있습니다. 이 게시물은 릴리스 팀이 관리하며 메인 블로그에 게시됩니다.

블로그 게시물은 릴리스 당일에 해당 릴리스를 진행하는 릴리스 팀 구성원이 직접 게시합니다. 릴리스는 항상 목요일에 이루어집니다.

릴리스 게시물은 게시되기 전에 다음과 같은 초안 작성 과정을 거칩니다.

  1. 해당 릴리스의 마일스톤(예: 1.39.0)을 참고합니다.
  2. 충분히 중요하다고 판단되는 PR을 포함하며, 일부 항목은 주요 항목으로 부각합니다. 블로그 게시물은 보통 hackmd 문서에서 작성합니다.
  3. 헤드라인 항목은 때때로 서로 다른 사람이 작성하며, 저희는 각 하위 섹션을 동료 리뷰하려고 노력합니다.
  4. 블로그 게시물 초안은 최종 리뷰를 위해 릴리스 며칠 전에 블로그 저장소에 PR로 제출됩니다.

Inside Rust 블로그

Inside Rust 블로그에 무엇을 쓸지는 일반적으로 각 팀이 스스로 정할 수 있습니다.

Inside Rust 블로그 게시물의 대표적인 주제는 다음과 같습니다.

  • 새로운 이니셔티브 및 참여 요청
  • 진행 중인 작업의 업데이트 및 현황 보고
  • 설계 노트

승인 절차

Inside Rust 블로그와 메인 블로그 모두 최소 한 명의 승인이 필요합니다. 승인자는 다음 그룹 중 하나에 속해야 합니다.

  • 모든 팀 리드(최상위 팀 여부와 무관)
  • 모든 리더십 위원회 구성원
  • Rust 재단 프로젝트 이사

이들은 주로 inside-rust-reviewers 마커 팀1의 구성원입니다. 이는 메인 블로그와 Inside Rust 블로그 모두에 적용된다는 점에 유의하십시오(이름은 추후에 변경될 예정입니다).

승인 시에는 다음 사항을 평가해야 합니다.

  • 게시물의 어조와 내용이 공식 채널에 적합합니까?
    • 예를 들어, 다른 생태계나 언어에 대한 부정적인 언급은 피해야 합니다.
  • 게시물이 누구를 대표하여 작성되었는지 분명합니까?
    • 이는 작성자 표기뿐 아니라 사용된 표현에도 해당될 수 있습니다. 게시물이 Rust 프로젝트 전체를 대표하여 공식 입장을 밝히는 경우, 리더십 위원회 구성원 중 최소 한 명의 승인을 반드시 받으십시오. 게시물이 특정 팀을 대표하여 입장을 밝히는 경우, 해당 팀이 그 내용에 동의해야 합니다.

일반적으로 누군가(반드시 위의 승인자일 필요는 없습니다)가 게시물을 교정했는지 확인하는 것이 좋지만, 블로그에서는 대체로 완벽한 내용보다 게시가 막히지 않도록 하는 것을 우선시합니다. 위 사항은 일반적으로 이 사람이 여러분이 대표하여 게시하는 팀의 구성원일 것을 요구하지 않는다는 점에 유의하십시오. 다만 이 사람은 해당 게시물에 대해 알고 있어야 합니다.

리뷰 받기

Triagebot은 새로운 블로그 PR마다 리더십 위원회 대표를 자동으로 배정합니다. 리뷰를 제때 받지 못하고 있다면 이 대표에게 핑을 보내면 됩니다. 다만 팀 리드에게도 리뷰를 요청하면 더 빨리 리뷰를 받을 수도 있습니다. 다시 말해, 먼저 팀 리드에게 요청하고, 그다음 팀의 리더십 위원회 대표에게 핑을 보낸 뒤, 마지막으로 배정된 리뷰어에게 요청하는 순서로 에스컬레이션할 것을 권장합니다.

리뷰가 이루어지도록 하는 최종 책임은 배정된 리뷰어에게 있습니다.

일반적으로 첫 리뷰까지 최소 1주일 정도가 걸릴 것으로 예상하십시오. 최종 수정 사항에 대한 재리뷰나 최종 병합 버튼 누르기는 대개 신속하게 진행할 수 있습니다. 게시물을 병합해야 할 때 위 그룹의 구성원 중 시간이 되는 사람을 찾으십시오.


  1. 릴리스 블로그 게시를 위해 릴리스 팀 구성원도 이 팀에 포함되어 있지만, 현재로서는 임의의 게시물을 승인할 수 있는 승인자로 간주되지 않습니다. ↩