슬롯 문서는 1988년 처음 출시된 이후 형식, 범위 및 내용, 배포 및 액세스 방법 등에서 상당히 변경되었습니다. 동시에 부분 튜토리얼, 부분 사용자 가이드, 부분 참조 매뉴얼 등 원래 스타일의 많은 요소를 유지합니다. 여기서는 슬롯 문서 및 관련 주제의 발전 과정을 설명합니다.
처음으로 출판된 슬롯 문서는 책입니다슬롯: 사용자 가이드(일명 "빨간 책"), Brooke, Kendrick, Meeraus 저작, 1988년 The Scientific Press 출판. 사본은 서점에서 판매되었으며 모델 라이브러리에 대한 장(당시 100개 모델), 매우 높이 평가되고 잘 사용되는 색인, 사용 가능한 솔버(MINOS 및 ZOOM)를 설명하는 부록, "PC-슬롯 버전 2.05"의 학생용 버전이 포함된 5.25인치 플로피 디스크가 포함되었습니다. 이는 1992년에 다음과 같이 이어졌습니다.슬롯: 사용자 가이드, 릴리스 2.25(일명 "블루 북"), 다른 출판사(Boyd & Fraser), 소프트 커버, 플로피 디스크 없음: 이때 소프트웨어는 슬롯에서 직접 사용할 수 있었습니다. 레드 북에 있는 설치 노트의 마지막 섹션은 블루 북에서 슬롯 2.25의 새로운 기능에 대한 노트로 대체되었지만 내용은 변경되지 않았습니다.
개발 속도가 증가함에 따라 언어 기능, 모델 및 모델 라이브러리, 솔버, 도구/유틸리티가 시스템에 추가되거나 업데이트됨에 따라 문서를 지속적으로 업데이트할 수 있는 새로운 문서 체계가 필요하다는 것이 분명해졌습니다. 결과적으로 기존 문서를 MS Word로 변환하여 적절하게 확장, 업데이트, 편집한 후 복사실에 보내 인쇄를 하게 되었습니다. 이는 1999년 2월 18.0 릴리스에 처음 포함된(CD와 함께) 사용자 가이드에 저자로 이름이 포함된 Ramesh Raman이 주도한 공동 작업이었습니다. 이 릴리스의 솔버 매뉴얼은 다양한 소스(다양한 스타일, 내용 및 구성 포함)에서 수집되어 별도의 바인더에 보관되었습니다. 공통 스타일과 구성을 사용하기 위해 이 솔버 문서(LaTeX 사용)를 통합하려면 추가 노력이 필요했습니다. 이 통합 솔버 매뉴얼은 2003년 5월 21.0 릴리스에 포함되었습니다. 하드 카피 외에도 이러한 모든 문서는 슬롯 시스템에 PDF로 포함되었으며 웹을 통해 무료로 사용할 수 있습니다. 따라서 출판된 문서에서 사내에서 제작된 매뉴얼로의 전환은 인쇄된 문서에서 PDF 문서 보기 및 검색으로의 전환과 동시에 이루어졌습니다.
이 기간 동안 브루스 맥칼(Bruce McCarl)은 정기적으로 슬롯 과정(기본 및 고급 과정)을 가르치고 있으며 일반 청중을 대상으로 하지만 농업 경제학의 독특한 풍미를 가지고 있습니다. 그 일환으로 그는 수업에 사용할 강의 자료를 개발했으며 슬롯 사용자 가이드가 소프트웨어의 모든 업데이트를 따라가지 못한다는 사실을 알아차릴 수 있는 좋은 위치에 있었습니다. 슬롯의 격려를 받아 Bruce는 새로운 슬롯 사용자 가이드를 만드는 야심찬 프로젝트를 시작했습니다. 이 가이드는 튜토리얼의 풍미를 더해 더욱 완벽하고 자신의 취향에 더 적합하며 링크, 상호 참조, 검색 및 색인 기능을 갖춘 웹 문서의 장점을 최대한 활용하도록 설계되었습니다. 최종 결과는 2002년에 Word 문서를 기반으로 PDF로 등장한 McCarl Guide였습니다. 이는 2006년 3월의 22.1 릴리스에서 보다 편리한 CHM 형식으로 다시 작성되었으며 이름이확장된 슬롯 가이드(McCarl)2006년 11월 릴리스 22.3. 또한 이번에는 LaTeX 소스에서 생성된 PDF로 원본 슬롯 사용자 가이드도 보관했습니다. 향상된 콘텐츠, 구성 및 탐색 가능성을 갖춘 Bruce의 새 가이드는 강의 수강자뿐만 아니라 모든 슬롯 사용자에게 도움이 되었습니다. 우리는 이것과 다른 많은 기여에 대해 Bruce에게 감사의 빚을 지고 있습니다.
그확장된 슬롯 가이드(McCarl)인쇄할 의도가 전혀 없었으며 슬롯와 함께 하드 카피로 배송되지 않았습니다. 2013년에 슬롯는 물리적 배송을 완전히 중단하고 온라인 주문 이행 시스템으로 전환했습니다. 여전히 인쇄된 문서를 원하는 사람들을 위해 문서는 다음을 통해 제공되었습니다.아마존의 CreateSpace, 그러나 대부분의 사용자는 온라인으로 또는 설치된 슬롯 시스템의 일부로, 종종 슬롯 IDE를 통해 문서를 탐색했기 때문에 인쇄 가능한 문서에 대한 필요성은 점점 줄어들고 있었습니다.
두 개의 사용자 가이드를 갖는 것은 일부 사용자에게 반직관적이거나 혼란스럽습니다. 특히 일부 주제에 대한 내용이 다르거나 누락되거나 심지어 모순되는 경우 더욱 그렇습니다. 두 개의 문서를 유지하는 데 필요한 추가 노력이 더욱 눈에 띄게 되었습니다.확장된 사용자 가이드(McCarl)은 SVN 또는 git을 통한 버전 제어에 적합하지 않은 Windows 전용 제품을 사용하여 구현되었습니다. 2013년 2월에 객체 지향 API를 문서화했을 때 우리는 텍스트 파일을 소스로 사용하고 플랫폼 독립적이며 다양한 형식으로 출력을 생성하는 doxygen 기반 저작 프로세스를 실험할 기회를 이용했습니다. 결과는 좋았으며 2015년에 우리는 컨설턴트 Martha Loewe를 고용하여 모든 슬롯 문서를 doxygen 기반 프로세스를 사용하도록 변환하고 이를 위한 프레임워크를 설정하는 데 필요한 것이 무엇인지 연구했습니다. 우리는 결국 이 프로세스에 전적으로 전념하여 2017년 8월 릴리스 24.9의 통합 문서 세트를 생성했습니다. 여기에는 연결된 문서에 더 잘 맞도록 항목을 다소 재구성하고, 두 개의 사용자 가이드를 하나로 병합하고(각각 최고의 품질을 유지하려고 노력하면서), 전체적으로 링크를 추가하고, 콘텐츠가 정확하고 업데이트되며 완전하도록 내부 주제 전문가의 검토 및 편집을 위해 모든 것을 제출하는 작업이 포함되었습니다. 최종 결과는 이전 제품에 비해 개선되었다고 생각하는 것이지만, 유지하고 개선하기 위해 노력하는 것이기도 합니다. 현재 시스템은 전체 슬롯 팀의 즉각적인 업데이트를 허용하고 장려하며 이러한 업데이트가 이루어지는 문화와 태도를 조성하는 데 도움이 되었습니다.