작성 모범 사례

개요 overview

이 페이지에서는 대상 설명서를 작성 페이지를 작성할 때 Adobe Experience Platform 설명서 품질 표준을 충족하도록 따라야 하는 규칙에 대해 설명합니다.

일반 지침 general-guidance

  • 대상 설명서의 템플릿을(를) 채우는 경우 연결, 테이블, 지원되는 Markdown 구문, 작성 지침 등에 대한 자세한 내용은 Adobe 기여자 안내서를 참조하십시오.
  • 제품 설명서에 관찰 및 추정을 포함하지 마십시오.
  • Experience Platform 설명서에서 Adobe 작성자는 굵은 서식 ​을 사용하여 다음과 같은 사용자 인터페이스 컨트롤을 참조합니다.
    • 연결 > 대상(으)로 이동한 다음 카탈로그 탭을 선택합니다. 대상 자습서에서 사용자 인터페이스 컨트롤을 문서화하는 방법의 예를 봅니다.

쓰기 스타일

IMPORTANT
대상 설명서 페이지 작성을 시작하기 전에 Adobe 설명서에 대한 작성 지침을 읽으십시오.
  • 문장을 짧게 유지하고 요점을 빨리 파악하세요. 문장의 길이가 20단어 이상이거나 여러 개의 쉼표를 사용하는 경우 별도의 문장으로 구분하는 것을 고려하십시오. 길이가 20단어가 넘는 문장은 독자들에게 특히 어려울 수 있다.
  • 너무 예의바르게 굴지 마라. 기술 설명서에서 "제발" 또는 "친절하게…"를 사용하지 마십시오.

연결 linking

제공된 설명서 템플릿을 따르고 템플릿의 기존 링크를 편집하지 마십시오. 새 링크를 포함할 때는 참가자 안내서의 설명서에서 링크 사용을 읽어 보십시오.

브랜딩 지침 branding

  • AEP는 승인된 공개 용어가 아닙니다. 처음 사용 시 Adobe Experience Platform을 사용한 다음 Experience Platform, 플랫폼을 사용하십시오.

    • 사용하지 않음: AEP에서 YourDestination으로 데이터를 내보내려면 먼저 이러한 필수 구성 요소를 읽고 완료해야 합니다.
    • 사용: Adobe Experience Platform에서 YourDestination으로 데이터를 내보내려면 먼저 이러한 필수 구성 요소를 읽고 완료해야 합니다.

이미지 및 스크린샷 images-and-screenshots

  • 이미지에 연결하는 방법에 대한 자세한 내용은 기여자 안내서를 참조하십시오.

  • 스크린샷을 사용할 때는 스크린샷이 전체 Platform UI 화면을 캡처하는지 확인하십시오.

  • 이미지를 표시하여 페이지의 특정 컨트롤이나 레이블을 강조 표시할 때는 Experience Platform 설명서 팀에서 사용하는 마크업 스타일을 따라야 합니다. 이 스크린샷에서 프로필 기반이 어떻게 강조 표시되는지 확인하십시오.

  • png 형식 이미지를 사용하십시오.

  • 번호가 매겨진 스크린샷을 파일 이름으로 사용하지 마십시오. 이미지 파일 이름은 설명적이어야 합니다.

    • 사용하지 않음: 1.png, 2.png, 3.png
    • 사용: yourdestination-authentication-details.png, yourdestination-destination-details.png
  • 설명서에 추가하는 이미지에 대해서는 대체 텍스트를 사용하고 대체 텍스트에 적절한 문법을 사용하십시오.

    • 사용하지 않음: 대상 연결 세부 정보
    • 사용: 채워진 대상 연결 세부 정보를 표시하는 플랫폼 UI의 이미지입니다.

프로세스 process

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6