누군가가 사용자 DOCO를 작성해야하기 때문에 기술 작가가 필요합니다. 프로그래머와 관리자는 지옥을 원하지 않는다고 확신합니다. 이것이 실제로 당신이 악한 이유의 일부입니다. 내 경험상, 대부분의 프로그래머와 관리자는 원한다면 매뉴얼을 쓸 수 있다고 생각합니다. 그들은 기술 작가와 같은 모든 “꽃”을 쓸 수는 없지만 그들이 쓰는 것은 정확합니다.
불행히도, 그것은 프로그래머와 관리자에게 중요한 일이 종종 있습니다.
소프트웨어 환경 내에서 정확도 = 품질이라는 느낌이 있습니다. 청중 분석, DOCO 가독성, 일관성, 유용성, 활성 및 수동적 음성, 세 개 이상의 항목 목록에있는 쉼표는…이 모든 것들은 기술 저술가를 제외한 모든 사람에게 상대적으로 중요하지 않습니다. 아… 그리고 사용자.
정확도가 모두 중요한 세상에서는 더미의 머리를 많이 넘어갑니다. 그것이 지적 snobbery인지는 모르겠지만 프로그래머와 관리자는 그들이 그것을 이해한다면 그것을 사용자에게도 그렇게 생각하는 것 같습니다. 그들이하는지 아닌지는 중요하지 않습니다 … 그들은해야합니다! 어리석은 사용자! 어쩌면 그것은 괴짜의 궁극적 복수일지도 모른다…
문서는 100% 정확할 수 있지만 청중이 읽을 수 없다면 시간을 낭비했습니다.
그렇다면 왜 아무도 이것을 인정하지 않습니까? 그들은합니다! 그것은 이상한 부분입니다. 이론적으로, 모두가 당신과 동의합니다. 실제로는 추위에 자신을 발견하는 것이 실제로입니다. 왜 이런 일이 일어나는지 모르겠습니다. 아마도이 사람들의 대부분이 기술 작곡을 한 적이 없기 때문일 수 있습니다 폰테크.
따라서 기술 작가는 중요하지 않은 것들에 대해 너무 오래 걱정합니다. 그리고 그들은 중요하지 않은 것들로 프로그래머와 관리자를 귀찮게합니다. 그러나 그들은 필요한 것입니다. 그렇지 않으면 왜 당신은 고용 될 것입니다. 아마도 간단한 논리의 부재는 그들의 두뇌를 회로로 만들 수 있습니다. 누가 알아?
우리가 이것에서 얻을 수있는 것은 기술 작가가 시간을 낭비한다는 느낌이 들기 때문에 그 결과 소프트웨어 세계의 힙 맨 아래에 있습니다. 좋은 비유는 부자가 가난한 사람들을 보는 방식이라고 생각합니다. 더러운 작은 생물… 우리가 그들없이 할 수 있다면…
그러나 업면이 있습니다. 나는 당신이 그것이 모두 나쁘다고 생각하고 싶지 않습니다.
힙의 바닥에 있으면 장점이 있습니다. 원한다면 몇 년 동안 눈에 띄지 않을 수 있습니다. 영화, 사무실 공간을 보지 못했다면 고용해야합니다. 몇 년 전“가자”라는 사람들은 약간의 녀석이 있습니다. 문제는 아무도 그에게 말한 적이 없으며, 급여의 결함 때문에 그는 여전히 돈을 받았다. 아무도 눈치 채지 못했습니다.
기술 작가가되는 것은 조금 비슷합니다.
도코 팀을 관리 할 때 가장 좋아하는 말은“우리가해야 할 일은 그들의 기대와 약속을 관리하는 것입니다”였습니다. 프로그래머와 관리자는 DOCO 팀에서 무슨 일이 일어나고 있는지 알지 못한다는 사실에 사임하기 때문에 때로는 느슨해 지려는 유혹이 있습니다. 이 유혹에 포기하지 마십시오 !!! 당신이 잡히면, 그것을하는 것은 늑대를 울부 짖는 소년과 같을 것입니다. 그들은 다시는 당신의 추정치를 믿지 않을 것입니다!
다른 위험은 긴급 감각을 잃을 것이라는 것입니다. 그리고 그것은 좋은 일꾼을 만드는 것의 큰 부분입니다. 당신은 당신의 약속 관리에 대해 매우 엄격해야합니다. 이것은 징계가 필요합니다. 때로는 당신이 신경 쓰는 유일한 사람 인 것처럼 보이지만 그렇게해야하기 때문입니다.
그러나 당신이 알아야 할 한 가지는 소프트웨어의 평균 기술 작가가 글쓰기 시간의 약 50% 만 소비한다는 것입니다. 나머지 시간은 계획, 문제 해결, 컴퓨터 수정, 프로그래머 조사, 인터뷰, 작업장 작성에 소비됩니다.
나는 항상 그것이 좋은 균형이라는 것을 알았습니다.
팀을 관리하기 시작했을 때 바닥이 실제로 떨어졌습니다. 그런 다음 백분율은 약 10-20%로 떨어졌습니다. 도움을 쓰지 않고 몇 달을 갈 때가있었습니다. 특히 관리하는 것을 좋아하지 않는다면 매우 실망 스러울 수 있습니다.
이제 소프트웨어에서 기술 작가를 관리하는 것은 흥미로운 일입니다. 대부분의 기술 관리 직책과 마찬가지로 회사에서 가장 선임적이고 숙련 된 사람이기 때문에 당신은 그것에 빠지게됩니다. 불행히도, 그것은 당신이 관리자가 될 자격이 없습니다. 소프트웨어 회사는 실제 교육이나 지원없이 사람들을 관리 역할로 덤프하는 것으로 유명합니다.
여기에 당신에게 조언이 없습니다. 그런 일이 발생하면 일어날 것입니다. 그것을 알고, 관리 역할에 빠지면 어려울 것입니다. (그래도 보람이 없다고 말하는 것은 아닙니다…)
아이러니 한 것은 가장 어려운 측면은 직원이 시스템을 바꾸려고 비명을 지르고 있다는 것입니다. “프로그래머는 우리의 질문에 대답하지 않습니다!” “지난 2 개월 동안 내 작업은 검토되지 않았습니다!” “프로젝트 관리자는 방금 품질을 잊어 버리라고 말했습니다!”
불행히도, 경험이없는 기술 작가는 종종 시스템을 바꿀 수 있다고 생각할 정도로 순진합니다. 일단 관리자가되면 할 수 없다는 것을 알고 있습니다. 잠깐만 … 어쩌면 무관심은 당신이 관리자가 될 자격이있는 것일 수도 있습니다… 흠.
어쨌든 내 조언은 너무 세게 밀지 않는 것입니다. 당신은 당신의 관리자를 위해 인생을 힘들게 만들고 나쁜 평판을 줄 것입니다. 당신이 필요한 악임을 인식하고 그러한 제약 내에서 일하십시오.
기술 쓰기는 많은 재미가 될 수 있습니다. 그리고 누군가가 창의적이지 않다고 말하지 마십시오. “이름을 입력”하지 않고 이름 필드에있는 것이 무엇인지 설명하는 방법을 생각하려고 노력하는 것은 진정한 마음의 목소리입니다!
