[HIG] Offering help
상황에 맞게 도움을 제공하는 방법
본 문서는 Apple의 Human Interface Guideline(이하 HIG) 문서를 한글로 번역한 것입니다. iOS 생태계 내에서 HIG를 읽으시는 분들이 번역본이 없어 불편함을 겪는 것을 알게 되었고, 이에 한글로 번역을 하게 되었습니다. iOS 커뮤니티 Async Swift에서 자율적으로 모인 9명이 함께 번역했으며, 일체의 상업적인 목적을 띄지 않습니다. 이 문서를 학습에 적극적으로 이용해 주시돼, 상업적인 용도로 이용하시는 것은 지양해 주시기 바랍니다. 감사합니다.
Introduction
접근하기 쉽고 직관적인 경험이 가장 효과적이지만 필요하다면 상황에 맞는 도움을 사람들에게 제공할 수 있습니다.
Best practices
사람들이 현재 하고 있는 작업을 통해 어떤 도움을 필요로 하는지 알 수 있습니다. 순서대로 간단한 작업 설명을 보여줘서 사람들이 단계별로 간단한 작업을 할 수 있도록 도와줍니다. 반면에 복잡하고 여러 단계가 있는 앱이나 게임 같은 경우 튜토리얼이나 목표를 달성하는 방법을 알려줄 수 있습니다. 사람들이 현재 하고 있는 작업에 직접적인 도움을 줄 수 있는 경우에만 도움을 주세요.
도움말 콘텐츠에 관련된 일관성 있는 용어와 이미지를 사용하세요. 도움말이 항상 현재 상황에 적합한지 확인해야 합니다. 예를 들면 사용자들이 tvOS에서 Siri Remote를 사용할 때 게임 컨트롤러에 대한 팁이나 이미지를 보여주지 않습니다. 또한 사용하는 용어와 설명이 플랫폼과 적합한지 확인해야 합니다. 예를 들면 iPhone에서 버튼을 클릭한다거나 Mac에서 메뉴 항목을 탭 하는 문구는 적합하지 않기에 사용하지 않습니다.
역자설명 : 하단의 이미지가 Siri Remote입니다. tvOS에서 사용하는 입력 장치 중 하나입니다.
모든 도움말 콘텐츠가 포괄적인(Inclusion)지 확인해야 합니다. 가이드라인은 Inclusion을 참고하세요.
역자설명 : 포괄적인(Inclusion)의 의미는 다양한 인종, 성별, 문화, 장애 등에 의해 어려움이나 불편함을 느끼지 않게 보편적이며 모든 사람을 고려한 설계를 말합니다.
기본적인 구성 요소나 패턴 또는 작동방식을 설명하는 불필요한 내용으로 도움말 콘텐츠 채우지 않습니다. 대신 앱이나 게임에서 지원하는 기본 구성 요소의 디테일한 순서나 작업을 설명합니다. 만약 앱 경험에서 Siri Remote를 90도 회전해서 사용하는 것처럼 독특한 조작이나 표준적이지 않은 입력 장치의 사용이 필요하다면 사람들에게 긴 설명 대신 애니메이션이나 그래픽을 사용해 빠르게 알려주는 것이 좋습니다.
Platform considerations
No additional considerations for iOS, iPadOS, tvOS, or watchOS.
macOS
도움말 태그(tooltip)는 인터페이스 내 구성요소 사용 방법을 간략하게 설명하는 간단한 보기 스타일입니다. iPhone과 iPad를 포함해 Mac에서 실행 가능한 앱의 도움말 태그는 요소(element)에 마우스 포인터를 잠시 올려놓았을 때 나타납니다.
역자설명 : 하단의 이미지는 도움말 태그(tooltip)의 예시입니다. macOS에서 마우스를 사용자가 원하는 요소(element)에 올려두면 해당 요소(element)를 설명하는 간단한 텍스트가 나옵니다.
마우스 포인터 바로 아래의 컨트롤 방법을 설명하세요. 사람들이 특정한 요소(element)의 컨트롤 방법을 알고 싶을 때 주변 요소(element)의 컨트롤 방법이나 상위의 작업 수행 방법을 알고 싶어 하지 않습니다.
시작되는 과정이나 작업에 대해 설명해야 합니다. ”기본 설정 복원”이나 “목록에서 언어 추가 또는 제거”와 같은 동사형으로 설명하는 것이 좋습니다.
간략히 하세요. 가능한 한 태그 내용을 최대 60-75자로 제한합니다.(현지화로 인해 텍스트 길이가 변경될 수 있습니다.) 간단하고 직접적인 설명을 위해 단편적이고 생략된 문장을 사용하는 것이 좋습니다. 만약 긴 텍스트로 설명해야 하는 경우 인터페이스 디자인을 단순화하는 것이 좋습니다.
일반적으로 구성요소의 이름을 지정하거나 참조하지 않습니다. 도움말 태그는 대부분 컨트롤 바로 위에 보입니다. 제어명이나 레이블을 단순히 설명하는 태그를 정의하지 않습니다.
상황에 맞는 도움말 태그를 제공합니다. 예를 들면 같은 컨트롤이더라도 상태가 다르면 다른 텍스트를 제공합니다.
