사양 및 문서 작성을위한 Wiki와 같은 도구 [닫기]


9

소프트웨어 프로젝트의 사양 및 문서를 작성하고 관리하기위한 Wiki 또는 Wiki와 유사한 시스템을 찾고 있습니다.

사용 가능한 위키 구현이 많이 있다는 것을 알고 있지만 이러한 종류의 작업에 특히 적합한 것이 있습니까?

실제로 wiki 일 필요는 없으며 스펙과 문서를 쉽게 작성하고 탐색 할 수 있으며 변경 추적을 지원하는 시스템 일뿐입니다.


1
특별한 플랫폼을 사용하고 있습니까? 예를 들어 Microsoft의 TFS처럼?
Saeed Neamati

@Saeed가 요청한 내용과 함께 팀 / 조직이 지식 관리 및 공유를 위해 어떤 종류의 인프라를 갖추고 있습니까? 또한 사양 및 문서 작성을위한 현재 프로세스는 무엇입니까?
토마스 오웬스

답변:


6

우리는 LaTeX와 SVN을 사용하고 있습니다. LaTeX 문서는 텍스트 파일 일 뿐이므로 일부 이진 또는 부분 이진 형식과 달리 버전 제어에서 잘 작동합니다.

코드와 함께 사용하는 데 익숙한 버전 제어의 모든 장점 (및 단점)을 얻을 수 있습니다.

LaTeX는 약간의 설정 (자신의 스타일 / 클래스를 정의하기 위해)을 설정하지만 일단 완료하면 매우 좋습니다. 프리젠 테이션 대신 컨텐츠에만 집중할 수 있습니다. WYSIWYG)를 사용하면서도 전문가 수준의 매끄러운 PDF 문서를 얻을 수 있습니다.


4

개인적으로 저는 Tiddly Wiki를 정말 좋아 합니다.

그것은 완전히 완전한 위키 구문을 가지고 있으며, 자체 포함 된 단일 html 파일이며 서버가 필요없이 다양한 웹 브라우저와 잘 작동합니다.

또한 확장 가능한 플러그인 아키텍처를 사용하여 티 들러 암호화 또는 각주 추가와 같은 모든 종류의 흥미로운 작업을 수행하기 위해 플러그인을 추가 할 수 있습니다.


3

Microsoft 플랫폼의 경우 SharePoint와의 TFS (Team Foundation Server) 통합이 바로 검색 대상입니다. 새로운 팀 프로젝트를 만들어 소프트웨어 개발 프로세스의 거의 모든 측면을 포괄하는 템플릿을 선택할 수 있습니다. 또한 팀원을 정의하고, 역할 및 보안 권한을 할당하고, 프로젝트와 관련된 문서 및 사양을 업로드, 공유 및 편집하고 다른 멋진 작업을 수행 할 수있는 포털을 제공합니다.

다른 플랫폼의 경우 GitHub 와 같은 것을 사용할 수 있다고 생각합니다 (물론 확실하지 않습니다).



0

선택한 소스 제어 관리 인프라에 문서를 체크인 한 상태에서 Sphinx를 사용해 볼 수 있습니다 . 소스 컨트롤과 상대적으로 가벼운 마크 업 언어 인 reStructuredText 의 장점을 가지고 있으며, 배우기 쉽고 HTML (PDF, PDF 등) 로의 변환에 매우 적합합니다.

당사 사이트를 사용함과 동시에 당사의 쿠키 정책개인정보 보호정책을 읽고 이해하였음을 인정하는 것으로 간주합니다.
Licensed under cc by-sa 3.0 with attribution required.