문제

나는 추가했다 SuperUser 에서이 질문 사용자의 관점에서.

따라서 Delphi 또는 .NET에서 데스크탑 시스템에서 실행되는 응용 프로그램을 만듭니다. 모든 종류의 기능과 멋진 기능을 갖춘 멋진 GUI. 잘 작동하고 테스트는 거의 버그가 없다고 말하고 배치하려고합니다 ...

기다리다! 도움말 파일이 필요하므로 사용자는 응용 프로그램에서 컨텍스트에 민감한 도움말을 호출 할 수 있습니다!

아니면 아니야? 요즘 HelpFiles가 데스크탑 응용 프로그램에 대한 요구 사항입니까? 그리고 그들은 실제로 문맥에 감지해야합니까? 사용자의 손을 잡고 "생년월일"이라는 분야 에서이 분야에서 출생의 날을 채워야한다고 말하면서 말입니다. 아니면 헬프 파일이 조금 구식이되고 있습니까?

이것은 내가 궁금해하는 것이며 이것은 약간 주관적이므로 데스크탑 응용 프로그램을 개발하는 모든 분들에게 다른 것을 물어볼 것입니다. (여전히) 컨텍스트 감지 헬프 파일을 제공합니까?

예, 또는 아니오, 제발. 주관적인 텍스트를 자유롭게 추가하십시오. 그러나 나에게 중요한 것은 현대 개발자가 여전히 GUI 응용 프로그램에 컨텍스트 감지 도움말을 추가하고 있는지 아는 것입니다.

(BTW, 나 자신은 수동으로 인쇄 할 수있는 비 컨텍스트 PDF 파일로 이동했습니다. 유지 관리가 훨씬 쉽습니다.)

도움이 되었습니까?

해결책

네 저도 그렇습니다.

이유 : 사용자가 프로그램의 작동 방식을 알기를 기대할 수 없습니다. 자, "생년월일"필드에 입력해야 할 사항을 설명하는 것은 약간 극단적이지만 소프트웨어 시스템에는 일반적으로 더 복잡한 것들이 있습니다. 오늘날 비용 회계 시스템에 대한 도움말 파일을 작성해야했으며 계산에 사용해야하는 가격을 결정하는 시스템이 어떻게 작동하는지 설명했습니다. 어떤 사용자 가이 도움말 파일을 사용하여 시스템을 구성하는 방법을 알지 못할 것이라고 생각합니다.

다른 팁

개발자가 아닌 사용자로 말하기 - 예, 컨텍스트 민감한 도움말 파일을 원합니다.

예를 들어 - 현재 새로운 프로젝트에 포함시키기 위해 제 3 자 컨트롤을 평가하고 있습니다. 컨텍스트에 민감한 도움이 좋은 컨트롤 (즉, 속성 창에서 속성을 선택하거나 코드의 키워드를 선택하고 F1을 눌러 도움말 주제로 바로 이동할 수 있음)은 배우고 사용하기가 훨씬 쉽습니다.

우리는 현재는 아니지만 많은 Windows 앱을 작성하지 않습니다. 대부분은 웹 기반입니다. 대부분의 Windows 앱은 상당히 작고 도움말 파일 외부에 문서화되어 있습니다.

또한 우리는 사용자가 개발 과정에서 문서를 작성하도록하므로 문서는 이해할 수있는 것입니다.

그러나 많은 사용자 (내부 앱이 아님)를 위해 대형 앱을 작성하는 경우 컨텍스트 감지 도움말 파일을 포함합니다. 나는 과거에 우리의 더 큰 앱 중 일부를 위해 그것을 해냈고, 내부 비 내부 상황에서는 매우 도움이됩니다.

실제로, 우리는 이제 웹 사이트를 설계하여 컨텍스트에 민감한 "도움이 필요합니다"기능을 갖추고 있으며 기능이 잘 알려져 있습니다. 회사 웹 사이트 나 내부에 관계없이 현재 모든 웹 개발에 통합하고 있습니다.

도움이 없습니까? 기술적으로 기울어지고 새로운 소프트웨어를 가지고 놀기를 좋아하는 사람들에게는 괜찮습니다. 그러나 기술에 정통하지 않은 사람들이 소프트웨어를 사용하는 경우 도움이 필수적입니다. 날짜의 예를 들어보세요. 국제 시장이 있다면 프로그램에 필요한 것을 더 잘 설명합니다. 미국인은 MM/DD/YYYY 형식을 사용하지만 대부분의 국제 사용자는 DD/MM/YYYY를 사용합니다. 프로그램에 필요한 내용을 철자해야합니다.

저는 최종 사용자와 운영 방식에 대한 단서가 전혀없는 많은 개발자와 함께 일했습니다. 예를 들어, 새로운 회사를 주장한 CTO는 고객이 업데이트가있을 때마다 고객이 모든 PDF와 대부분의 도움말 주제를 인쇄한다는 것을 알지 못하고 인쇄용 문서를 제거해야합니다. 최종 사용자와 시장을 알아야합니다. 불행히도, 너무 많은 개발자들이 다른 개발자들에 둘러싸여 거품 속에 살고 있습니다.

개발자가 도움을 주어야합니까? 아마 그렇지 않을 것입니다. 일반적인 최종 사용자처럼 생각할 수 없다면, 초안 노트, 기술 작가가 기술 정보를 최종 사용자가 필요로하는 수준으로 떨어 뜨릴 수 있도록하십시오.

최근의 응용 프로그램에서는 상황에 맞는 도움을 제공하지 않았습니다. 이것은 다른 무엇인가보다는 기술적 인 이유가있었습니다 (도움말 파일은 본질적으로 다국어 문서 책 파일이며, 이론적으로는 컨텍스트에 민감한 도움을 지원하지만 잘 작동하지 않았습니다). 응용 프로그램의 각 창/대화 상자마다 하나의 페이지가 있으며 모든 컨트롤이 설명되어 있습니다. 그러나 각 컨트롤에는 상당히 포괄적 인 툴팁이있어 추가 도움이 필요합니다. 각 대화 상자에는 대화 상자 별 페이지를 가져 오는 도움말 버튼이 있습니다. 역사적으로, 툴팁 텍스트를 도움말 파일에 저장할 수는 있지만 최근 도움말 시스템에서는 작동하지 않는 것 같습니다. 그리고 그들은 어쨌든 자원에 저장되어 있습니다.

그러나 그것은 모든 사람을위한 응용 프로그램이 아닙니다. 응용 프로그램으로 관리 할 수있는 네트워크 시스템은 그 자체로 복잡한 주제이므로 어쨌든 사용자를위한 특별 교육이 있으며 응용 프로그램은 네트워크 시스템을 알고 있으면 응용 프로그램도 알 수 있도록 설계되었습니다. 다시 말해, 응용 프로그램 모델은 사용자 모델과 잘 어울릴 정도로 포괄적 인 도움말 기능이 필요하지 않습니다. 이것이 모든 응용 프로그램 개발의 목표 여야합니다.

컨트롤에 대한 도움말 파일의 대부분의 정보는 실제로 아무도 필요하지 않기 때문에 이미 툴팁에있는 것 이상이 아닙니다.

Office 및 Visual Studio는 문제를 해결했습니다. 눌린 도움말은 단일 컨트롤이 아닌 전체 대화 상자의 도움말 페이지를 엽니 다.

대화 상자의 일부가 너무 복잡하여 추가 설명이 필요하고 (더 쉽게 할 수 있도록 재 설계 할 수 없음) 컨트롤 바로 옆에 설명을 넣을 수 있습니다. 이것은 특수한 경우에 많은 응용 프로그램에서 사용되므로 사용자는 특정 텍스트를 작성 해야하는 방식을 찾아야하기 때문에 워크 플로가 중단되지 않습니다.

나는 응용 프로그램에서 상황에 관계없이 도움을 준 적이 없으며 다른 응용 프로그램에서 직접 사용할 수있을 정도로 충분히 구현 된 것을 보지 못했습니다. 제 생각에,이를 수행하는 데 필요한 노력은 혜택을 능가합니다.

마지막 응용 프로그램 에서이 결정을 내려야 할 위치에 관여했을 때, 우리는 응용 프로그램에 툴팁 풍선을 사용했으며, 사용자가 각 컨트롤 위에 호버링했을 때 텍스트 풍선을 표시했습니다. 또한 기존 매뉴얼을 제공했는데,이 매뉴얼은 대부분 단계별 스크린 샷이 많은 연습을 제공했습니다.

잠시 후 사용자는 풍선을 아프게하고 우리가 제공 한 확인란으로 끄었지만 초보자가 시작하는 데 도움이되는 것 같습니다.

모든 응용 프로그램에는 응용 프로그램의 모든 중요한 기능에 대한 툴팁 (Office 2007 팁과 유사) 형태의 컨텍스트 감지 도움말이 있습니다.

우리는 기존의 본격적인 도움말 파일을 제공하지는 않지만 정기적으로 업데이트하는 지식 기반이 있습니다. 이것은 전화, 이메일 등을 통해 고객에게 제공되는 모든 도움의 모음으로, 모든 문제에 대해 적절하게 분류되고 쉽게 검색 할 수 있습니다. 이것은 결국 고객이 무엇보다도 원하는 것이 아니라 더 많은 도움이되는 최선의 도움이됩니다. 우리 처음에는 그들이 필요할 수 있다고 생각합니다.

소수의 고객은 지식 기반을 한눈에 볼 수있는 한 눈에 띄지 않고 항상 우리에게 연락을 취하지 않지만 여전히 휠 시간을 재창조하는 데 도움이됩니다.

나는 당신에게 개인적인 의견을 제시합니다.

도움말 파일을 작성하는 것은 과거에 모든 것이 새롭고 온라인 리소스가 거의 없었던 과거에 유용했습니다. 오늘날 대부분의 컴퓨터 사용자는 직접 탐색을 통해 배웁니다. 툴팁 형태의 상황에 맞는 도움은 훌륭하고 강력하게 권장됩니다.이 탐사 학습에 대한 힌트를줍니다.

클릭 할 수있는 링크가 많은 도움말 문서는 어떻습니까? 글쎄, 그것은 분명히 훌륭하지만, 내가 생각하는 것은 거의 사용하지 않았다. 대부분의 경우 사용자는 적절한 Google 검색으로 답변을 얻을 수 있습니다. 또한 이런 종류의 문서는 다음과 같습니다 값비싼. 개발자가 작성할 수 없습니다. 기술적 인 글쓰기와 명확성으로 관련 기술로 특정 사람들을 고용하거나 할당해야합니다.

이 결정을 관리해야한다면, 나는 당신의 응용 프로그램에 대해 매우 난해하고 특별한 (고유 한) 기능에 대해서만 전체 문서를 제공 할 것입니다. 어쨌든 상황에 맞는 도움말 파일 대신 온라인 자습서를 향한 경향이 있습니다. 이는 애플리케이션 사용이 얼마나 어려운지에 대한 정보를 제공하는 추가 이점과 가장 많이 요청 된 핫스팟이 무엇인지 (온라인 문서에 대한 히트 및 참조 자 검색 쿼리를 평가 함)

툴팁과 일반적으로 사용자의 컴퓨터 능력이 향상되면 일부 응용 프로그램은 도움말 파일 없이는 잘 작동합니다. 그러나 일부 애플리케이션에는 응용 프로그램 사용만큼 일반적인 주제 정보에 대한 도움말 파일이 필요합니다. 예를 들어, 사진 앱에서는 사용자 작업이 자체적으로 분명하더라도 JPEG 압축을 설명하고 도움말 파일에 일부 샘플을 포함시킬 수 있습니다.

Microsoft는 상황에 맞는 도움의 감소, 더 나은 또는 악화에 대한 기여자 인 것 같습니다. 첫째, Visual Studio의 도움말 시스템은 약간의 사용에 사용할 고통입니다. 둘째, Visual Studio Help System의 사용 편의성은 내리막 길을 크게 내려 왔습니다. 나는 rant를 생략하지만 그것이 필요하다고 말하면 충분합니다. 많은 VS2008 도움말에서 관련 정보를 얻기 위해 더 많은 클릭 및 스크롤. 이는 응용 프로그램의 도움말 시스템에 대한 표준이 낮은 경향이 있습니다.

라이센스 : CC-BY-SA ~와 함께 속성
제휴하지 않습니다 StackOverflow
scroll top