사양 및 문서 작성을위한 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.