목표는 다음과 같은 주요 요구 사항을 갖춘 온라인 문서 시스템을 갖추는 것입니다.
- 는 주로 모든 응용 프로그램의 최종 기술 문서에 대한 중간 단계로 사용됩니다 (아마도 절대로 완료되지는 않습니다 :]). 일반적으로 다음과 같이 사용됩니다. 누군가 문제가 있고 수정 한 후 수정 사항을 즉시 기록해 둡니다. 지금 일어나고있는 일은 관리 할 수없는 상태가되었습니다. 누군가 문제가 있습니다. 문제를 해결했습니다. 저와 누군가는 행복하지만 2 개월 후에는 다른 사람이 같은 문제를 겪고 있으며 수정 사항을 기억하지 않습니다.
- 아파치 서버 뒤에서 실행하여 어디서나 액세스 가능
- 읽기 전용 / 읽기 / 쓰기 / 관리자 액세스를 허용하는 사용자 / 그룹 관리
- 형식은 그렇게 중요하지 않습니다 : 일반 텍스트는 할 것이고 위키 스타일은 더 좋을 것입니다
- 싸거나 무료
내 아이디어 :
- 파일 공유 또는 ssh를 통해 파일을 제공하기 만하면됩니다 (단점 : Windows와 너무 호환되지 않음, 전문가 : 단순, 모든 파일 형식 일 수 있음)
- SCM에 보관하십시오 (svn / git, 위와 같지만 액세스 및 액세스 제어가 쉬움)
- 합류 : 우리는 이미 Jira를 사용하고 있습니다. 합류는 그만한 가치가 있습니까? Jira와 어떻게 통합됩니까?
- 다른 것?
이에 대해 의견을 주거나 다른 시스템과 경험을 공유하십시오.
문서가 코드 (예 : Javadocs)로 생성되거나 처음부터, 사용자 안내서 또는이 둘의 조합으로 작성되고 있습니까?
—
FrustratedWithFormsDesigner
그것은 주로 더 많은 사용자 가이드, 코드가 아닌 문서의이다 (물론, 우리는뿐만 아니라, doxygen에 의해 생성 된, 우리가 그것을 포함 할 수 있음을 가지고 있지만, 그것은 관심의 첫 번째 지점이 아니다)
—
스테인
나는 현금을 Spolsky에게 넘겨 줄 것입니다.
—
Job