코드 주석
추후 조치를 위한 주석
미래에 처리될 것으로 예상되는 코드에 주석을 추가할 때 기술적 부채 이슈를 생성하세요. 그런 다음, 코드에 생성한 주석에 대한 링크를 넣어주세요. 이렇게 함으로써 다른 개발자들은 주석이 여전히 관련이 있는지 빠르게 확인할 수 있고, 이를 해결하기 위해 무엇을 해야 하는지 알 수 있습니다.
예시:
# Deprecated scope until code_owner column has been migrated to rule_type.
# To be removed with https://gitlab.com/gitlab-org/gitlab/-/issues/11834.
scope :code_owner, -> { where(code_owner: true).or(where(rule_type: :code_owner)) }
클래스 및 메소드 설명
메소드 인수나 반환 값을 문서화할 때 YARD 구문을 사용하세요.
YARD 구문을 사용하지 않은 예시:
class Order
# 사용자의 이메일 주소로 연관된 주문 ID를 찾습니다.
def order_ids_by_email(email)
# ...
end
end
YARD 구문을 사용한 예시:
```ruby
class Order
# 사용자의 이메일 주소로 연관된 주문 ID를 찾습니다.
#
# @param email [String, Array