이제 JMP Genomics v4.1 생산에 갔을 때, 나는 나의 독서를 따라 잡을 시간이 조금 있음을 발견했다. 내가 최근에 발행 한 미국 과학 아카데미 회보 (미국) , 나는 5 페이지의 전통적인 한도가 폐지되었고 6 페이지 이상의 기사가 보편화되었다는 사실에 충격 받았다. 조사관이 점점 더 많은 정보를 가능한 한 많은 정보를 제공하려고 할 때 논문이 늘어났습니다. 심지어 저자 과학 전통적으로 2500 단어로 제한된 보고서는 정기적으로 링크를 포함하여 페이지 제한을 극복합니다. 온라인 자료 지원 방대한 양의 추가 데이터 및 설명이 포함 된 웹 사이트. 이 모든 정보는 독자를 압도하는 경향이 있습니다.
아마도 나는 단지 내 나이를 다시 보여주고있을 뿐이지 만, 엄격하게 시행되는 일련의 단어 나 페이지에 제한을 두었던 날은 놓칠 수 있습니다. 보충 온라인 자료 . 저자는 좋은 이야기를하는 데 필요한 모든 지원 사실과 인물이 기사에 포함되도록해야했습니다. 이러한 요구 사항으로 인해 작성자는 어떤 데이터가 가장 중요한 것인지 신중하게 고려하고 가능한 가장 간결한 언어를 사용했습니다. 좋은 종이는 날카로운 면도날이었고 당신이 알아야 할 것을 말했습니다. 그들은 읽는 즐거움이었습니다.
"사실, 부인 ..."
옛날에 저인망 TV 시리즈 (저는 확실히 여기에 제 나이를 보여주고 있습니다!), Joe Friday는이 단어를 사용하여 모든 보풀을 잘라내어 본질에 이르기까지했습니다. 우리는 JMP Genomics에 대한 문서를 작성할 때도 동일한 철학을 따릅니다. 우리는 JMP Genomics 사용자 가이드 주제별로 9 개의 서로 다른 볼륨으로 나눕니다. 각 프로세스를 자체 장에서 설명합니다. 우리는 프로세스가 무엇인지, 그리고 프로세스를 실행하는 데 필요한 것이 무엇인지 알려줍니다. 그런 다음 예제를 보여주고 결과를 해석하는 방법을 알려줍니다.
각 장은 같은 방식으로 구성됩니다. 하나의 프로세스에서 어떻게 작동하는지 배우면 모든 프로세스에서 어떻게 작동하는지 알 수 있습니다.
다른 소프트웨어 패키지를 문서화 한 내 동료는 최근 JMP Genomics 문서가 다소 간단하다고 말했습니다. 모욕을받는 것이 아니라 칭찬의 가장 좋은 형태로 그녀의 의견을 말했습니다. 소프트웨어 문서에는 많은 솜털 모양이 들어 있어서는 안됩니다. 대신, 그것은 당신이 당신이 쉽게 접근 할 수있는 형식으로 알아야 할 것을 알려주고 그 후에 그것을 벗어나야합니다.
그만큼 JMP Genomics 사용자 가이드 바로 그 일을하도록 설계되었습니다.