1

문제점은 제 개발자 중 상당수가 필요한 최소한의 디자인 설명서를 작성하지 않고 있다는 것입니다. 글쎄, 동료 개발자들이 TFS/SharePoint에서 그것을 찾아서 읽지 않는다는 사실에 좌절감을 느낀다.Visual Studio : 디자인 문서 폴더 향상

나는 이것을하기위한 모든 정상적인 방법을 시도해 왔지만 당연히 보통의 불만들이 만들어졌다. "오, 정말 미안하지만, 정말 바쁘다. 나는 코드에 몇 가지 주석을 썼다.

나를 이해하는 데있어 문제가되는 머리를 싸우는 것보다 약간의 동정심이 필요하다. 나를 도와 줄 뭔가가있을지라도.

누구나 특수 목적의 설명서 폴더를 Visual Studio Projects 및 솔루션에 생성하기위한 Visual Studio Extension에 대해 알고 있습니다. TFS, SharePoint 또는 어디에서나 접근 할 수있는 문서를로드 할 수있는 약간의 영리함을 가지고 뭔가 특별한 기능이있는 사용자 지정 폴더 (속성 폴더와 약간 비슷 함)를 사용하여 솔루션 및 프로젝트에 표시 할 수있는 기능을 생각 중입니다. 모든 문서 유형을 저장하고 올바른 응용 프로그램으로보기/편집을 위해 열 수 있어야합니다. 다른 약간의 영리는 포함 할 수 있었다; 솔루션과 프로젝트, 메일 병합 속성 변경, 코드에 대한 양방향 참조 링크, 이 아닌 경우이 연결된 작업 항목이 업데이트 될 때 업데이트 됨.

이 경우 사용할 수있는 모든 프로젝트 및 솔루션 만들기 및 다음 내 dev 's 덜 설명서를 읽기/쓰기위한 변명있을 것이라고 포함 할 것입니다. (나는 완전한 글 읽기 프로그래밍을위한 타협이라고 생각합니다. 어쨌든 마녀는 C# 스타일의 언어로는 잘 작동하지 않습니다.)

나는 이것을 구현할 것이지만 실제로는 바쁜 글 쓰는 중 ... 그래서 이것은 약간의 시간을 손에 들고 누군가에게 기회가 될 수 있다고 생각합니다. 결과가 많은 사람들이 건축가와 팀 리더를 훨씬 더 행복하게 할 수있는 도전을 좋아합니다 ...

저장
+0

나는 그런 것들을 찾기가 어려울 것이라고 생각합니다. 저는 모든 도구가 할 수있는 증상에 붕대를 감으 려하지 않고 대신에 근본 원인을 알아 내고 동기 부여 및 의사 소통 문제가되는 것을 해결해야한다고 제안합니다. –

답변

0

는 :

난 당신이 새로운 만들 suggets (당신이 당신의 대역폭을 증가시키지 않도록하기위한 코드 소스의 다른) 당신의 문서에 대한 구체적인 Team Project 쉽게 시각화하기 위해 Source Control에서 액세스 할 수 있습니다. 생성 문서에 대한

: 소스 코드에 대한

, 당신은 Ghost Doc 사용할 수 있습니다, 단지 바로 가기로 솔루션에 대한 의견을 생성,하지만 당신은 모든 항목에 대한 템플릿을 정의해야합니다.샌드캐슬 또는 Doxygen을가

링크를 compoment http://submain.com/products/ghostdoc.aspx

들어하는 단어의 PDF 문서를 생성, 당신은 사용할 수 있습니다 당신은

링크 과정을 자동화하기 위해 InvokeProcessActivity에 따라 custom activity을 사용할 수 있습니다 : http://sandcastle.codeplex.com/

링크 : http://www.stack.nl/~dimitri/doxygen/

비고; docs dev를 따르고 싶다면 doc 전용의 workitem을 작성하고 체크인을 통해 팀이 파일을 첨부하는지 확인하는 것이 좋습니다.이 솔루션은 적은 비용으로 권장됩니다. 이 삽입물의 경우 check In Policy

관련 문제