How to select an applicant with good documentation skillsShould I file my checklists as documentation?Recommended software for centralizing IT documentationHow should an applicant react to an early invitation to an interview?How can I tell if a job applicant has the right technical skills?Bad documentation - authority undiscerningMention studying leaked documentation in interviewHow to inform the employer about delays in obtaining the necessary documentationPoor documentation cultureFormer manager who left company is asking for documentation I prepared as his direct reportHow to deal with missing interview skills but good coding skills / strong resume?
Where did the extra Pym particles come from in Endgame?
Confusion about capacitors
Were there two appearances of Stan Lee?
Historically, were women trained for obligatory wars? Or did they serve some other military function?
Why do Ichisongas hate elephants and hippos?
Do I have to worry about players making “bad” choices on level up?
Can fracking help reduce CO2?
Why “le” behind?
How can Republicans who favour free markets, consistently express anger when they don't like the outcome of that choice?
What does 「再々起」mean?
Feels like I am getting dragged in office politics
If Earth is tilted, why is Polaris always above the same spot?
Minimum value of 4 digit number divided by sum of its digits
Are Boeing 737-800’s grounded?
What is a Recurrent Neural Network?
How to back up a running remote server?
Examples of non trivial equivalence relations , I mean equivalence relations without the expression " same ... as" in their definition?
Find the coordinate of two line segments that are perpendicular
Are some sounds more pleasing to the ear, like ㄴ and ㅁ?
Modify locally tikzset
Weird result in complex limit
Binary Numbers Magic Trick
Python "triplet" dictionary?
How do I tell my manager that he's wrong?
How to select an applicant with good documentation skills
Should I file my checklists as documentation?Recommended software for centralizing IT documentationHow should an applicant react to an early invitation to an interview?How can I tell if a job applicant has the right technical skills?Bad documentation - authority undiscerningMention studying leaked documentation in interviewHow to inform the employer about delays in obtaining the necessary documentationPoor documentation cultureFormer manager who left company is asking for documentation I prepared as his direct reportHow to deal with missing interview skills but good coding skills / strong resume?
.everyoneloves__top-leaderboard:empty,.everyoneloves__mid-leaderboard:empty,.everyoneloves__bot-mid-leaderboard:empty margin-bottom:0;
We are a local outsourcing company and currently hiring for a technical position (Linux/Network engineer) - however our main objective now is to find someone not only able in the Linux/Networking field but also - and mainly - keen to create documentation about everything they learn while getting up to speed with our clients and keep the documentation current.
We used to have one such guy in the past - he kept taking notes and creating wiki pages about everything important. Sadly he left us some time ago and the team's docs quality has gone downhill very quickly. Our engineers can certainly be pushed into writing some docs but they only do enough to get the managers off their backs, but not nearly as a useful resource. I accept it - some people are born writers some are not (and I'm one of the latter group, I admit).
What interview questions would you use to identify whether someone is that kind of documentation freak that we now need?
interviewing hiring-process documentation
asked Mar 18 '15 at 23:12
MLuMLu
14115
|
show 2 more comments
We are a local outsourcing company and currently hiring for a technical position (Linux/Network engineer) - however our main objective now is to find someone not only able in the Linux/Networking field but also - and mainly - keen to create documentation about everything they learn while getting up to speed with our clients and keep the documentation current.
We used to have one such guy in the past - he kept taking notes and creating wiki pages about everything important. Sadly he left us some time ago and the team's docs quality has gone downhill very quickly. Our engineers can certainly be pushed into writing some docs but they only do enough to get the managers off their backs, but not nearly as a useful resource. I accept it - some people are born writers some are not (and I'm one of the latter group, I admit).
What interview questions would you use to identify whether someone is that kind of documentation freak that we now need?
interviewing hiring-process documentation
asked Mar 18 '15 at 23:12
MLuMLu
14115
3
If you want to know if they are a documentation freak ask them "How do you feel about writing documentation". If they like writing documentation they will tell you.
– paparazzo
Mar 19 '15 at 13:13
The documentation role is more that of a business / systems analyst than of an engineer. Perhaps you should recruit for a combination position.
– Wesley Long
Mar 19 '15 at 16:12
@Wesley - If you aren't willing to do the documentation then you really shouldn't be calling yourself an engineer. Developer maybe, but certainly not engineer which implies a bit higher degree of professionalism.
– Dunk
Mar 19 '15 at 20:22
@Dunk - Respectfully, I disagree. An engineer's role is to develop solutions, and to document their own work. It is not their role to document the work and systems of others. That is what business analysts and technical writers do. That's the reason these positions exist.
– Wesley Long
Mar 19 '15 at 20:23
@Wesley - As long as you agree that an engineer's role includes documenting at least their own work then I'm ok with that.
– Dunk
Mar 19 '15 at 20:59
|
show 2 more comments
We are a local outsourcing company and currently hiring for a technical position (Linux/Network engineer) - however our main objective now is to find someone not only able in the Linux/Networking field but also - and mainly - keen to create documentation about everything they learn while getting up to speed with our clients and keep the documentation current.
We used to have one such guy in the past - he kept taking notes and creating wiki pages about everything important. Sadly he left us some time ago and the team's docs quality has gone downhill very quickly. Our engineers can certainly be pushed into writing some docs but they only do enough to get the managers off their backs, but not nearly as a useful resource. I accept it - some people are born writers some are not (and I'm one of the latter group, I admit).
What interview questions would you use to identify whether someone is that kind of documentation freak that we now need?
interviewing hiring-process documentation
asked Mar 18 '15 at 23:12
MLuMLu
14115
We are a local outsourcing company and currently hiring for a technical position (Linux/Network engineer) - however our main objective now is to find someone not only able in the Linux/Networking field but also - and mainly - keen to create documentation about everything they learn while getting up to speed with our clients and keep the documentation current.
We used to have one such guy in the past - he kept taking notes and creating wiki pages about everything important. Sadly he left us some time ago and the team's docs quality has gone downhill very quickly. Our engineers can certainly be pushed into writing some docs but they only do enough to get the managers off their backs, but not nearly as a useful resource. I accept it - some people are born writers some are not (and I'm one of the latter group, I admit).
What interview questions would you use to identify whether someone is that kind of documentation freak that we now need?
interviewing hiring-process documentation
interviewing hiring-process documentation
asked Mar 18 '15 at 23:12
MLuMLu
14115
asked Mar 18 '15 at 23:12
MLuMLu
14115
asked Mar 18 '15 at 23:12
MLuMLu
14115
asked Mar 18 '15 at 23:12
MLuMLu
14115
asked Mar 18 '15 at 23:12
MLuMLu
14115
14115
3
If you want to know if they are a documentation freak ask them "How do you feel about writing documentation". If they like writing documentation they will tell you.
– paparazzo
Mar 19 '15 at 13:13
The documentation role is more that of a business / systems analyst than of an engineer. Perhaps you should recruit for a combination position.
– Wesley Long
Mar 19 '15 at 16:12
@Wesley - If you aren't willing to do the documentation then you really shouldn't be calling yourself an engineer. Developer maybe, but certainly not engineer which implies a bit higher degree of professionalism.
– Dunk
Mar 19 '15 at 20:22
@Dunk - Respectfully, I disagree. An engineer's role is to develop solutions, and to document their own work. It is not their role to document the work and systems of others. That is what business analysts and technical writers do. That's the reason these positions exist.
– Wesley Long
Mar 19 '15 at 20:23
@Wesley - As long as you agree that an engineer's role includes documenting at least their own work then I'm ok with that.
– Dunk
Mar 19 '15 at 20:59
|
show 2 more comments
3
If you want to know if they are a documentation freak ask them "How do you feel about writing documentation". If they like writing documentation they will tell you.
– paparazzo
Mar 19 '15 at 13:13
The documentation role is more that of a business / systems analyst than of an engineer. Perhaps you should recruit for a combination position.
– Wesley Long
Mar 19 '15 at 16:12
@Wesley - If you aren't willing to do the documentation then you really shouldn't be calling yourself an engineer. Developer maybe, but certainly not engineer which implies a bit higher degree of professionalism.
– Dunk
Mar 19 '15 at 20:22
@Dunk - Respectfully, I disagree. An engineer's role is to develop solutions, and to document their own work. It is not their role to document the work and systems of others. That is what business analysts and technical writers do. That's the reason these positions exist.
– Wesley Long
Mar 19 '15 at 20:23
@Wesley - As long as you agree that an engineer's role includes documenting at least their own work then I'm ok with that.
– Dunk
Mar 19 '15 at 20:59
3
3
If you want to know if they are a documentation freak ask them "How do you feel about writing documentation". If they like writing documentation they will tell you.
– paparazzo
Mar 19 '15 at 13:13
If you want to know if they are a documentation freak ask them "How do you feel about writing documentation". If they like writing documentation they will tell you.
– paparazzo
Mar 19 '15 at 13:13
The documentation role is more that of a business / systems analyst than of an engineer. Perhaps you should recruit for a combination position.
– Wesley Long
Mar 19 '15 at 16:12
The documentation role is more that of a business / systems analyst than of an engineer. Perhaps you should recruit for a combination position.
– Wesley Long
Mar 19 '15 at 16:12
@Wesley - If you aren't willing to do the documentation then you really shouldn't be calling yourself an engineer. Developer maybe, but certainly not engineer which implies a bit higher degree of professionalism.
– Dunk
Mar 19 '15 at 20:22
@Wesley - If you aren't willing to do the documentation then you really shouldn't be calling yourself an engineer. Developer maybe, but certainly not engineer which implies a bit higher degree of professionalism.
– Dunk
Mar 19 '15 at 20:22
@Dunk - Respectfully, I disagree. An engineer's role is to develop solutions, and to document their own work. It is not their role to document the work and systems of others. That is what business analysts and technical writers do. That's the reason these positions exist.
– Wesley Long
Mar 19 '15 at 20:23
@Dunk - Respectfully, I disagree. An engineer's role is to develop solutions, and to document their own work. It is not their role to document the work and systems of others. That is what business analysts and technical writers do. That's the reason these positions exist.
– Wesley Long
Mar 19 '15 at 20:23
@Wesley - As long as you agree that an engineer's role includes documenting at least their own work then I'm ok with that.
– Dunk
Mar 19 '15 at 20:59
@Wesley - As long as you agree that an engineer's role includes documenting at least their own work then I'm ok with that.
– Dunk
Mar 19 '15 at 20:59
|
show 2 more comments
3 Answers
3
active
oldest
votes
To all the pompous people who think that documentation is somehow not a useful thing or below their dignity, please try working with code/systems that are undocumented and/or not self documenting. Sure, you can use your brilliant engineering mind to figure it all out. But, you'll lose a lot of time. You might even make mistakes and then start over. So, please spare us the "developers should not make documentation" slogans.
EDIT - Refer end of answer.
I am not a professional & have never hired anyone. But, here are a few suggestions for how you could judge a person's interest in documentation.
1 - Ask him how he feels about writing documentation.
Personal example - I absolutely love it. Actually, I love teaching and simplifying things for others. Maybe that is where my love for documentation comes from. I like to keep it short, but informative.
2 - Ask him about his frustrations with badly documented systems.
Personal example - It took me 2 months to understand something that could have been understood in 1-2 weeks.
3 - Ask him about how he improved documentation in his previous company or how his documentation helped people.
Personal example - People often used to ask me how to use some features of internal apps. I saw too many requests of the same kind. So I created detailed documentation for it. Next time, I just shared the links to the docs. I never got any further requests after most of those requests. Maybe I did a good job.
4 - Ask him to describe a few things and see how he does it.
Notes - Consider that an audience does not know what a car is. I know people who'd begin describing a car in terms of engines, combustion, thermodynamics etc. when they should really be talking about 4 wheels, steering and moving from place A to B.
You could ask him about things that you know about better than him. Eg. What is a test automation framework and what does it really do ?
5 - Ask him to write a manual for any daily object.
Notes - Maybe your soda vending machine in your office ? See the kinds of questions he asks when documenting the object. If he does not ask the right questions, then he might not get the right info. If that happens, then his docs will not be effective.
6 - Ask him if he wrote blogs, github docs or self documenting code.
PS - Hope this helps. I guess I just showed some of my love for documentation. Off to punching out some code !
EDITS -
To clarify, by "documentation", I don't mean long manuals and such. It can be short too, depending on your audience. If someone wants more details (like interns), then they can talk to the developer. Documentation can have different forms. In software development, that can be self descriptive code and comments.
answered Feb 3 '17 at 0:48
SenseiTesterSenseiTester
13314
Agree with what Jeff said - give good documenters credit for their work. Also give them incentives. You could go cheap and let them go, only to realize how valuable they were, when you have to waste time and money to figure out poorly documented things.
– SenseiTester
Feb 3 '17 at 0:57
spare us the "developers should not make documentation", well on ther other hand, you're often ask to write "a documentation" without a clear objective, and I won't talk about all the times I have to write a installation/exploitation documentation which belong to the system area (in which I'm not supposed to be competent since there are the system guys for that). And the thing I hate the more is when I have detail every single step (click on next, open the command by typing "cmd" in the startup menu,...) so even a five years old kid should be able to do it.
– Walfrat
Feb 3 '17 at 12:32
I mean, do aircraft engineer write their documentation so even a five years old kid can build a plane ? Why should we then ? Just get a decent System administrator.
– Walfrat
Feb 3 '17 at 12:33
1
@Walfrat - Your aircraft example does not make sense. I often see these kinds of examples given by people who don't want to document things at all or write self-documenting code. Do you or anyone here knows 5 year olds who can create a plane ? Certainly not. Then why would the aircraft engineering team create manuals for 5 year olds ? I don't know about that industry. But, I'd imagine that they'll probably create documentation on how to wire the electrical systems for electrical technicians etc.
– SenseiTester
Feb 3 '17 at 21:03
1
The bottom line is that one has to be smart about what to document and how much to document. That is something only you can figure out in your own situation.
– SenseiTester
Feb 3 '17 at 21:06
|
show 3 more comments
If you're looking for interview questions, there are basically two:
- Do you have any previous job experience where you had to write a lot of documentation?
- Are you willing to write documentation?
Other than this, you may want to get some writing examples or rely on the correspondence you get during the interview process: CV, cover letter, email.
Personally, I think your approach is only a part of an over-all solution. Documentation becomes important when it is evaluated and relied upon. Someone should be doing a periodic review of the documents. The objective should be whether or not the documents were created but are they useful to anyone else. When I create instructions for a particular task, I observe someone reading and executing the instructions and ask that they sort of "think aloud" so I can tell if I've given enough information. I take notes if there are any hesitations or questions.
Determine the purpose of the documentation and have an effective way to know if they've met that objective. Writing takes practice along with getting valuable feedback. When the consumers of the documents (or someone to simulate a future user), indicate which parts don't make sense, the writer soon learns how to communicate more effectively.
It would be sad for you to hire someone who is very good at writing documentation but over time they discover that you neglect, fail to acknowledge and give them no credit doing it. Also, they need to know that you understand the time commitment and won't pressure them to complete other tasks with unrealistic time limits and then punish them for not writing adequate documentation.
Documentation becomes important when it is evaluated and relied upon. This is definitively the most important part, lot of us hate to do documentation and generally the argument is always the same "NOBODY AIN'T GONNA READ IT/IT WON'T BE UPDATED". Which is... still too often true ?
– Walfrat
Feb 3 '17 at 12:25
1
Question 3: "Do you have any examples of your past writing you can share with us, and can you discuss how you approached those?"
– keshlam
Feb 5 '17 at 5:16
@Walfrat - Especially when someone agrees to a tight deadline it isn't communicated that it will get done, but at a lower quality with no documentation or testing.
– user8365
Feb 8 '17 at 13:24
add a comment |
I myself am in a situation where I have to demonstrate that I know how to document:
I have answered a few questions on stackoverflow.com, and I believe that the way I answered these questions is a good reflection on how well I can write documentation.
I run a couple of blogs. While they need an update, I believe that they expose the quality of my technical writing pretty well.
If it's doable, ask to see current writing samples.
Back in December 1999, I successfully interviewed for a position as a marketing analyst for a high tech marketing consulting company. The core of the interview was a one-hour writing test on any technical subject. The interviewer ripped the paper out of my hand within 30 minutes - and almost gave me a paper cut - he'd seen enough, and I got my phone call the next day :)
If writing ability is important to you, I expect that you'd have filtered out those who sent you poorly written cover letters and resumes. A poorly written, poorly organized Linkedin profile is a no-no :)
edited 25 mins ago
Krinkle
1031
answered Mar 19 '15 at 10:22
Vietnhi PhuvanVietnhi Phuvan
69.8k7120256
Paper? Nobody wants to see my handwriting. My writing, I hope, is another matter.
– keshlam
Feb 3 '17 at 1:12
add a comment |
Your Answer
StackExchange.ready(function()
var channelOptions =
tags: "".split(" "),
id: "423"
;
initTagRenderer("".split(" "), "".split(" "), channelOptions);
StackExchange.using("externalEditor", function()
// Have to fire editor after snippets, if snippets enabled
if (StackExchange.settings.snippets.snippetsEnabled)
StackExchange.using("snippets", function()
createEditor();
);
else
createEditor();
);
function createEditor()
StackExchange.prepareEditor(
heartbeatType: 'answer',
autoActivateHeartbeat: false,
convertImagesToLinks: false,
noModals: true,
showLowRepImageUploadWarning: true,
reputationToPostImages: null,
bindNavPrevention: true,
postfix: "",
imageUploader:
brandingHtml: "Powered by u003ca class="icon-imgur-white" href="https://imgur.com/"u003eu003c/au003e",
contentPolicyHtml: "User contributions licensed under u003ca href="https://creativecommons.org/licenses/by-sa/3.0/"u003ecc by-sa 3.0 with attribution requiredu003c/au003e u003ca href="https://stackoverflow.com/legal/content-policy"u003e(content policy)u003c/au003e",
allowUrls: true
,
noCode: true, onDemand: false,
discardSelector: ".discard-answer"
,immediatelyShowMarkdownHelp:true
);
);
Sign up or log in
StackExchange.ready(function ()
StackExchange.helpers.onClickDraftSave('#login-link');
);
Sign up using Google
Sign up using Facebook
Sign up using Email and Password
Post as a guest
Required, but never shown
StackExchange.ready(
function ()
StackExchange.openid.initPostLogin('.new-post-login', 'https%3a%2f%2fworkplace.stackexchange.com%2fquestions%2f42961%2fhow-to-select-an-applicant-with-good-documentation-skills%23new-answer', 'question_page');
);
Post as a guest
Required, but never shown
StackExchange.ready(function ()
$("#show-editor-button input, #show-editor-button button").click(function ()
var showEditor = function()
$("#show-editor-button").hide();
$("#post-form").removeClass("dno");
StackExchange.editor.finallyInit();
;
var useFancy = $(this).data('confirm-use-fancy');
if(useFancy == 'True')
var popupTitle = $(this).data('confirm-fancy-title');
var popupBody = $(this).data('confirm-fancy-body');
var popupAccept = $(this).data('confirm-fancy-accept-button');
$(this).loadPopup(
url: '/post/self-answer-popup',
loaded: function(popup)
var pTitle = $(popup).find('h2');
var pBody = $(popup).find('.popup-body');
var pSubmit = $(popup).find('.popup-submit');
pTitle.text(popupTitle);
pBody.html(popupBody);
pSubmit.val(popupAccept).click(showEditor);
)
else
var confirmText = $(this).data('confirm-text');
if (confirmText ? confirm(confirmText) : true)
showEditor();
);
);
3 Answers
3
active
oldest
votes
3 Answers
3
active
oldest
votes
active
oldest
votes
active
oldest
votes
To all the pompous people who think that documentation is somehow not a useful thing or below their dignity, please try working with code/systems that are undocumented and/or not self documenting. Sure, you can use your brilliant engineering mind to figure it all out. But, you'll lose a lot of time. You might even make mistakes and then start over. So, please spare us the "developers should not make documentation" slogans.
EDIT - Refer end of answer.
I am not a professional & have never hired anyone. But, here are a few suggestions for how you could judge a person's interest in documentation.
1 - Ask him how he feels about writing documentation.
Personal example - I absolutely love it. Actually, I love teaching and simplifying things for others. Maybe that is where my love for documentation comes from. I like to keep it short, but informative.
2 - Ask him about his frustrations with badly documented systems.
Personal example - It took me 2 months to understand something that could have been understood in 1-2 weeks.
3 - Ask him about how he improved documentation in his previous company or how his documentation helped people.
Personal example - People often used to ask me how to use some features of internal apps. I saw too many requests of the same kind. So I created detailed documentation for it. Next time, I just shared the links to the docs. I never got any further requests after most of those requests. Maybe I did a good job.
4 - Ask him to describe a few things and see how he does it.
Notes - Consider that an audience does not know what a car is. I know people who'd begin describing a car in terms of engines, combustion, thermodynamics etc. when they should really be talking about 4 wheels, steering and moving from place A to B.
You could ask him about things that you know about better than him. Eg. What is a test automation framework and what does it really do ?
5 - Ask him to write a manual for any daily object.
Notes - Maybe your soda vending machine in your office ? See the kinds of questions he asks when documenting the object. If he does not ask the right questions, then he might not get the right info. If that happens, then his docs will not be effective.
6 - Ask him if he wrote blogs, github docs or self documenting code.
PS - Hope this helps. I guess I just showed some of my love for documentation. Off to punching out some code !
EDITS -
To clarify, by "documentation", I don't mean long manuals and such. It can be short too, depending on your audience. If someone wants more details (like interns), then they can talk to the developer. Documentation can have different forms. In software development, that can be self descriptive code and comments.
answered Feb 3 '17 at 0:48
SenseiTesterSenseiTester
13314
Agree with what Jeff said - give good documenters credit for their work. Also give them incentives. You could go cheap and let them go, only to realize how valuable they were, when you have to waste time and money to figure out poorly documented things.
– SenseiTester
Feb 3 '17 at 0:57
spare us the "developers should not make documentation", well on ther other hand, you're often ask to write "a documentation" without a clear objective, and I won't talk about all the times I have to write a installation/exploitation documentation which belong to the system area (in which I'm not supposed to be competent since there are the system guys for that). And the thing I hate the more is when I have detail every single step (click on next, open the command by typing "cmd" in the startup menu,...) so even a five years old kid should be able to do it.
– Walfrat
Feb 3 '17 at 12:32
I mean, do aircraft engineer write their documentation so even a five years old kid can build a plane ? Why should we then ? Just get a decent System administrator.
– Walfrat
Feb 3 '17 at 12:33
1
@Walfrat - Your aircraft example does not make sense. I often see these kinds of examples given by people who don't want to document things at all or write self-documenting code. Do you or anyone here knows 5 year olds who can create a plane ? Certainly not. Then why would the aircraft engineering team create manuals for 5 year olds ? I don't know about that industry. But, I'd imagine that they'll probably create documentation on how to wire the electrical systems for electrical technicians etc.
– SenseiTester
Feb 3 '17 at 21:03
1
The bottom line is that one has to be smart about what to document and how much to document. That is something only you can figure out in your own situation.
– SenseiTester
Feb 3 '17 at 21:06
|
show 3 more comments
To all the pompous people who think that documentation is somehow not a useful thing or below their dignity, please try working with code/systems that are undocumented and/or not self documenting. Sure, you can use your brilliant engineering mind to figure it all out. But, you'll lose a lot of time. You might even make mistakes and then start over. So, please spare us the "developers should not make documentation" slogans.
EDIT - Refer end of answer.
I am not a professional & have never hired anyone. But, here are a few suggestions for how you could judge a person's interest in documentation.
1 - Ask him how he feels about writing documentation.
Personal example - I absolutely love it. Actually, I love teaching and simplifying things for others. Maybe that is where my love for documentation comes from. I like to keep it short, but informative.
2 - Ask him about his frustrations with badly documented systems.
Personal example - It took me 2 months to understand something that could have been understood in 1-2 weeks.
3 - Ask him about how he improved documentation in his previous company or how his documentation helped people.
Personal example - People often used to ask me how to use some features of internal apps. I saw too many requests of the same kind. So I created detailed documentation for it. Next time, I just shared the links to the docs. I never got any further requests after most of those requests. Maybe I did a good job.
4 - Ask him to describe a few things and see how he does it.
Notes - Consider that an audience does not know what a car is. I know people who'd begin describing a car in terms of engines, combustion, thermodynamics etc. when they should really be talking about 4 wheels, steering and moving from place A to B.
You could ask him about things that you know about better than him. Eg. What is a test automation framework and what does it really do ?
5 - Ask him to write a manual for any daily object.
Notes - Maybe your soda vending machine in your office ? See the kinds of questions he asks when documenting the object. If he does not ask the right questions, then he might not get the right info. If that happens, then his docs will not be effective.
6 - Ask him if he wrote blogs, github docs or self documenting code.
PS - Hope this helps. I guess I just showed some of my love for documentation. Off to punching out some code !
EDITS -
To clarify, by "documentation", I don't mean long manuals and such. It can be short too, depending on your audience. If someone wants more details (like interns), then they can talk to the developer. Documentation can have different forms. In software development, that can be self descriptive code and comments.
answered Feb 3 '17 at 0:48
SenseiTesterSenseiTester
13314
Agree with what Jeff said - give good documenters credit for their work. Also give them incentives. You could go cheap and let them go, only to realize how valuable they were, when you have to waste time and money to figure out poorly documented things.
– SenseiTester
Feb 3 '17 at 0:57
spare us the "developers should not make documentation", well on ther other hand, you're often ask to write "a documentation" without a clear objective, and I won't talk about all the times I have to write a installation/exploitation documentation which belong to the system area (in which I'm not supposed to be competent since there are the system guys for that). And the thing I hate the more is when I have detail every single step (click on next, open the command by typing "cmd" in the startup menu,...) so even a five years old kid should be able to do it.
– Walfrat
Feb 3 '17 at 12:32
I mean, do aircraft engineer write their documentation so even a five years old kid can build a plane ? Why should we then ? Just get a decent System administrator.
– Walfrat
Feb 3 '17 at 12:33
1
@Walfrat - Your aircraft example does not make sense. I often see these kinds of examples given by people who don't want to document things at all or write self-documenting code. Do you or anyone here knows 5 year olds who can create a plane ? Certainly not. Then why would the aircraft engineering team create manuals for 5 year olds ? I don't know about that industry. But, I'd imagine that they'll probably create documentation on how to wire the electrical systems for electrical technicians etc.
– SenseiTester
Feb 3 '17 at 21:03
1
The bottom line is that one has to be smart about what to document and how much to document. That is something only you can figure out in your own situation.
– SenseiTester
Feb 3 '17 at 21:06
|
show 3 more comments
To all the pompous people who think that documentation is somehow not a useful thing or below their dignity, please try working with code/systems that are undocumented and/or not self documenting. Sure, you can use your brilliant engineering mind to figure it all out. But, you'll lose a lot of time. You might even make mistakes and then start over. So, please spare us the "developers should not make documentation" slogans.
EDIT - Refer end of answer.
I am not a professional & have never hired anyone. But, here are a few suggestions for how you could judge a person's interest in documentation.
1 - Ask him how he feels about writing documentation.
Personal example - I absolutely love it. Actually, I love teaching and simplifying things for others. Maybe that is where my love for documentation comes from. I like to keep it short, but informative.
2 - Ask him about his frustrations with badly documented systems.
Personal example - It took me 2 months to understand something that could have been understood in 1-2 weeks.
3 - Ask him about how he improved documentation in his previous company or how his documentation helped people.
Personal example - People often used to ask me how to use some features of internal apps. I saw too many requests of the same kind. So I created detailed documentation for it. Next time, I just shared the links to the docs. I never got any further requests after most of those requests. Maybe I did a good job.
4 - Ask him to describe a few things and see how he does it.
Notes - Consider that an audience does not know what a car is. I know people who'd begin describing a car in terms of engines, combustion, thermodynamics etc. when they should really be talking about 4 wheels, steering and moving from place A to B.
You could ask him about things that you know about better than him. Eg. What is a test automation framework and what does it really do ?
5 - Ask him to write a manual for any daily object.
Notes - Maybe your soda vending machine in your office ? See the kinds of questions he asks when documenting the object. If he does not ask the right questions, then he might not get the right info. If that happens, then his docs will not be effective.
6 - Ask him if he wrote blogs, github docs or self documenting code.
PS - Hope this helps. I guess I just showed some of my love for documentation. Off to punching out some code !
EDITS -
To clarify, by "documentation", I don't mean long manuals and such. It can be short too, depending on your audience. If someone wants more details (like interns), then they can talk to the developer. Documentation can have different forms. In software development, that can be self descriptive code and comments.
answered Feb 3 '17 at 0:48
SenseiTesterSenseiTester
13314
To all the pompous people who think that documentation is somehow not a useful thing or below their dignity, please try working with code/systems that are undocumented and/or not self documenting. Sure, you can use your brilliant engineering mind to figure it all out. But, you'll lose a lot of time. You might even make mistakes and then start over. So, please spare us the "developers should not make documentation" slogans.
EDIT - Refer end of answer.
I am not a professional & have never hired anyone. But, here are a few suggestions for how you could judge a person's interest in documentation.
1 - Ask him how he feels about writing documentation.
Personal example - I absolutely love it. Actually, I love teaching and simplifying things for others. Maybe that is where my love for documentation comes from. I like to keep it short, but informative.
2 - Ask him about his frustrations with badly documented systems.
Personal example - It took me 2 months to understand something that could have been understood in 1-2 weeks.
3 - Ask him about how he improved documentation in his previous company or how his documentation helped people.
Personal example - People often used to ask me how to use some features of internal apps. I saw too many requests of the same kind. So I created detailed documentation for it. Next time, I just shared the links to the docs. I never got any further requests after most of those requests. Maybe I did a good job.
4 - Ask him to describe a few things and see how he does it.
Notes - Consider that an audience does not know what a car is. I know people who'd begin describing a car in terms of engines, combustion, thermodynamics etc. when they should really be talking about 4 wheels, steering and moving from place A to B.
You could ask him about things that you know about better than him. Eg. What is a test automation framework and what does it really do ?
5 - Ask him to write a manual for any daily object.
Notes - Maybe your soda vending machine in your office ? See the kinds of questions he asks when documenting the object. If he does not ask the right questions, then he might not get the right info. If that happens, then his docs will not be effective.
6 - Ask him if he wrote blogs, github docs or self documenting code.
PS - Hope this helps. I guess I just showed some of my love for documentation. Off to punching out some code !
EDITS -
To clarify, by "documentation", I don't mean long manuals and such. It can be short too, depending on your audience. If someone wants more details (like interns), then they can talk to the developer. Documentation can have different forms. In software development, that can be self descriptive code and comments.
answered Feb 3 '17 at 0:48
SenseiTesterSenseiTester
13314
edited Feb 3 '17 at 21:10
answered Feb 3 '17 at 0:48
SenseiTesterSenseiTester
13314
answered Feb 3 '17 at 0:48
SenseiTesterSenseiTester
13314
answered Feb 3 '17 at 0:48
SenseiTesterSenseiTester
13314
13314
Agree with what Jeff said - give good documenters credit for their work. Also give them incentives. You could go cheap and let them go, only to realize how valuable they were, when you have to waste time and money to figure out poorly documented things.
– SenseiTester
Feb 3 '17 at 0:57
spare us the "developers should not make documentation", well on ther other hand, you're often ask to write "a documentation" without a clear objective, and I won't talk about all the times I have to write a installation/exploitation documentation which belong to the system area (in which I'm not supposed to be competent since there are the system guys for that). And the thing I hate the more is when I have detail every single step (click on next, open the command by typing "cmd" in the startup menu,...) so even a five years old kid should be able to do it.
– Walfrat
Feb 3 '17 at 12:32
I mean, do aircraft engineer write their documentation so even a five years old kid can build a plane ? Why should we then ? Just get a decent System administrator.
– Walfrat
Feb 3 '17 at 12:33
1
@Walfrat - Your aircraft example does not make sense. I often see these kinds of examples given by people who don't want to document things at all or write self-documenting code. Do you or anyone here knows 5 year olds who can create a plane ? Certainly not. Then why would the aircraft engineering team create manuals for 5 year olds ? I don't know about that industry. But, I'd imagine that they'll probably create documentation on how to wire the electrical systems for electrical technicians etc.
– SenseiTester
Feb 3 '17 at 21:03
1
The bottom line is that one has to be smart about what to document and how much to document. That is something only you can figure out in your own situation.
– SenseiTester
Feb 3 '17 at 21:06
|
show 3 more comments
Agree with what Jeff said - give good documenters credit for their work. Also give them incentives. You could go cheap and let them go, only to realize how valuable they were, when you have to waste time and money to figure out poorly documented things.
– SenseiTester
Feb 3 '17 at 0:57
spare us the "developers should not make documentation", well on ther other hand, you're often ask to write "a documentation" without a clear objective, and I won't talk about all the times I have to write a installation/exploitation documentation which belong to the system area (in which I'm not supposed to be competent since there are the system guys for that). And the thing I hate the more is when I have detail every single step (click on next, open the command by typing "cmd" in the startup menu,...) so even a five years old kid should be able to do it.
– Walfrat
Feb 3 '17 at 12:32
I mean, do aircraft engineer write their documentation so even a five years old kid can build a plane ? Why should we then ? Just get a decent System administrator.
– Walfrat
Feb 3 '17 at 12:33
1
@Walfrat - Your aircraft example does not make sense. I often see these kinds of examples given by people who don't want to document things at all or write self-documenting code. Do you or anyone here knows 5 year olds who can create a plane ? Certainly not. Then why would the aircraft engineering team create manuals for 5 year olds ? I don't know about that industry. But, I'd imagine that they'll probably create documentation on how to wire the electrical systems for electrical technicians etc.
– SenseiTester
Feb 3 '17 at 21:03
1
The bottom line is that one has to be smart about what to document and how much to document. That is something only you can figure out in your own situation.
– SenseiTester
Feb 3 '17 at 21:06
Agree with what Jeff said - give good documenters credit for their work. Also give them incentives. You could go cheap and let them go, only to realize how valuable they were, when you have to waste time and money to figure out poorly documented things.
– SenseiTester
Feb 3 '17 at 0:57
Agree with what Jeff said - give good documenters credit for their work. Also give them incentives. You could go cheap and let them go, only to realize how valuable they were, when you have to waste time and money to figure out poorly documented things.
– SenseiTester
Feb 3 '17 at 0:57
spare us the "developers should not make documentation", well on ther other hand, you're often ask to write "a documentation" without a clear objective, and I won't talk about all the times I have to write a installation/exploitation documentation which belong to the system area (in which I'm not supposed to be competent since there are the system guys for that). And the thing I hate the more is when I have detail every single step (click on next, open the command by typing "cmd" in the startup menu,...) so even a five years old kid should be able to do it.– Walfrat
Feb 3 '17 at 12:32
spare us the "developers should not make documentation", well on ther other hand, you're often ask to write "a documentation" without a clear objective, and I won't talk about all the times I have to write a installation/exploitation documentation which belong to the system area (in which I'm not supposed to be competent since there are the system guys for that). And the thing I hate the more is when I have detail every single step (click on next, open the command by typing "cmd" in the startup menu,...) so even a five years old kid should be able to do it.– Walfrat
Feb 3 '17 at 12:32
I mean, do aircraft engineer write their documentation so even a five years old kid can build a plane ? Why should we then ? Just get a decent System administrator.
– Walfrat
Feb 3 '17 at 12:33
I mean, do aircraft engineer write their documentation so even a five years old kid can build a plane ? Why should we then ? Just get a decent System administrator.
– Walfrat
Feb 3 '17 at 12:33
1
1
@Walfrat - Your aircraft example does not make sense. I often see these kinds of examples given by people who don't want to document things at all or write self-documenting code. Do you or anyone here knows 5 year olds who can create a plane ? Certainly not. Then why would the aircraft engineering team create manuals for 5 year olds ? I don't know about that industry. But, I'd imagine that they'll probably create documentation on how to wire the electrical systems for electrical technicians etc.
– SenseiTester
Feb 3 '17 at 21:03
@Walfrat - Your aircraft example does not make sense. I often see these kinds of examples given by people who don't want to document things at all or write self-documenting code. Do you or anyone here knows 5 year olds who can create a plane ? Certainly not. Then why would the aircraft engineering team create manuals for 5 year olds ? I don't know about that industry. But, I'd imagine that they'll probably create documentation on how to wire the electrical systems for electrical technicians etc.
– SenseiTester
Feb 3 '17 at 21:03
1
1
The bottom line is that one has to be smart about what to document and how much to document. That is something only you can figure out in your own situation.
– SenseiTester
Feb 3 '17 at 21:06
The bottom line is that one has to be smart about what to document and how much to document. That is something only you can figure out in your own situation.
– SenseiTester
Feb 3 '17 at 21:06
|
show 3 more comments
If you're looking for interview questions, there are basically two:
- Do you have any previous job experience where you had to write a lot of documentation?
- Are you willing to write documentation?
Other than this, you may want to get some writing examples or rely on the correspondence you get during the interview process: CV, cover letter, email.
Personally, I think your approach is only a part of an over-all solution. Documentation becomes important when it is evaluated and relied upon. Someone should be doing a periodic review of the documents. The objective should be whether or not the documents were created but are they useful to anyone else. When I create instructions for a particular task, I observe someone reading and executing the instructions and ask that they sort of "think aloud" so I can tell if I've given enough information. I take notes if there are any hesitations or questions.
Determine the purpose of the documentation and have an effective way to know if they've met that objective. Writing takes practice along with getting valuable feedback. When the consumers of the documents (or someone to simulate a future user), indicate which parts don't make sense, the writer soon learns how to communicate more effectively.
It would be sad for you to hire someone who is very good at writing documentation but over time they discover that you neglect, fail to acknowledge and give them no credit doing it. Also, they need to know that you understand the time commitment and won't pressure them to complete other tasks with unrealistic time limits and then punish them for not writing adequate documentation.
Documentation becomes important when it is evaluated and relied upon. This is definitively the most important part, lot of us hate to do documentation and generally the argument is always the same "NOBODY AIN'T GONNA READ IT/IT WON'T BE UPDATED". Which is... still too often true ?
– Walfrat
Feb 3 '17 at 12:25
1
Question 3: "Do you have any examples of your past writing you can share with us, and can you discuss how you approached those?"
– keshlam
Feb 5 '17 at 5:16
@Walfrat - Especially when someone agrees to a tight deadline it isn't communicated that it will get done, but at a lower quality with no documentation or testing.
– user8365
Feb 8 '17 at 13:24
add a comment |
If you're looking for interview questions, there are basically two:
- Do you have any previous job experience where you had to write a lot of documentation?
- Are you willing to write documentation?
Other than this, you may want to get some writing examples or rely on the correspondence you get during the interview process: CV, cover letter, email.
Personally, I think your approach is only a part of an over-all solution. Documentation becomes important when it is evaluated and relied upon. Someone should be doing a periodic review of the documents. The objective should be whether or not the documents were created but are they useful to anyone else. When I create instructions for a particular task, I observe someone reading and executing the instructions and ask that they sort of "think aloud" so I can tell if I've given enough information. I take notes if there are any hesitations or questions.
Determine the purpose of the documentation and have an effective way to know if they've met that objective. Writing takes practice along with getting valuable feedback. When the consumers of the documents (or someone to simulate a future user), indicate which parts don't make sense, the writer soon learns how to communicate more effectively.
It would be sad for you to hire someone who is very good at writing documentation but over time they discover that you neglect, fail to acknowledge and give them no credit doing it. Also, they need to know that you understand the time commitment and won't pressure them to complete other tasks with unrealistic time limits and then punish them for not writing adequate documentation.
Documentation becomes important when it is evaluated and relied upon. This is definitively the most important part, lot of us hate to do documentation and generally the argument is always the same "NOBODY AIN'T GONNA READ IT/IT WON'T BE UPDATED". Which is... still too often true ?
– Walfrat
Feb 3 '17 at 12:25
1
Question 3: "Do you have any examples of your past writing you can share with us, and can you discuss how you approached those?"
– keshlam
Feb 5 '17 at 5:16
@Walfrat - Especially when someone agrees to a tight deadline it isn't communicated that it will get done, but at a lower quality with no documentation or testing.
– user8365
Feb 8 '17 at 13:24
add a comment |
If you're looking for interview questions, there are basically two:
- Do you have any previous job experience where you had to write a lot of documentation?
- Are you willing to write documentation?
Other than this, you may want to get some writing examples or rely on the correspondence you get during the interview process: CV, cover letter, email.
Personally, I think your approach is only a part of an over-all solution. Documentation becomes important when it is evaluated and relied upon. Someone should be doing a periodic review of the documents. The objective should be whether or not the documents were created but are they useful to anyone else. When I create instructions for a particular task, I observe someone reading and executing the instructions and ask that they sort of "think aloud" so I can tell if I've given enough information. I take notes if there are any hesitations or questions.
Determine the purpose of the documentation and have an effective way to know if they've met that objective. Writing takes practice along with getting valuable feedback. When the consumers of the documents (or someone to simulate a future user), indicate which parts don't make sense, the writer soon learns how to communicate more effectively.
It would be sad for you to hire someone who is very good at writing documentation but over time they discover that you neglect, fail to acknowledge and give them no credit doing it. Also, they need to know that you understand the time commitment and won't pressure them to complete other tasks with unrealistic time limits and then punish them for not writing adequate documentation.
If you're looking for interview questions, there are basically two:
- Do you have any previous job experience where you had to write a lot of documentation?
- Are you willing to write documentation?
Other than this, you may want to get some writing examples or rely on the correspondence you get during the interview process: CV, cover letter, email.
Personally, I think your approach is only a part of an over-all solution. Documentation becomes important when it is evaluated and relied upon. Someone should be doing a periodic review of the documents. The objective should be whether or not the documents were created but are they useful to anyone else. When I create instructions for a particular task, I observe someone reading and executing the instructions and ask that they sort of "think aloud" so I can tell if I've given enough information. I take notes if there are any hesitations or questions.
Determine the purpose of the documentation and have an effective way to know if they've met that objective. Writing takes practice along with getting valuable feedback. When the consumers of the documents (or someone to simulate a future user), indicate which parts don't make sense, the writer soon learns how to communicate more effectively.
It would be sad for you to hire someone who is very good at writing documentation but over time they discover that you neglect, fail to acknowledge and give them no credit doing it. Also, they need to know that you understand the time commitment and won't pressure them to complete other tasks with unrealistic time limits and then punish them for not writing adequate documentation.
answered Mar 19 '15 at 0:38
user8365
Documentation becomes important when it is evaluated and relied upon. This is definitively the most important part, lot of us hate to do documentation and generally the argument is always the same "NOBODY AIN'T GONNA READ IT/IT WON'T BE UPDATED". Which is... still too often true ?
– Walfrat
Feb 3 '17 at 12:25
1
Question 3: "Do you have any examples of your past writing you can share with us, and can you discuss how you approached those?"
– keshlam
Feb 5 '17 at 5:16
@Walfrat - Especially when someone agrees to a tight deadline it isn't communicated that it will get done, but at a lower quality with no documentation or testing.
– user8365
Feb 8 '17 at 13:24
add a comment |
Documentation becomes important when it is evaluated and relied upon. This is definitively the most important part, lot of us hate to do documentation and generally the argument is always the same "NOBODY AIN'T GONNA READ IT/IT WON'T BE UPDATED". Which is... still too often true ?
– Walfrat
Feb 3 '17 at 12:25
1
Question 3: "Do you have any examples of your past writing you can share with us, and can you discuss how you approached those?"
– keshlam
Feb 5 '17 at 5:16
@Walfrat - Especially when someone agrees to a tight deadline it isn't communicated that it will get done, but at a lower quality with no documentation or testing.
– user8365
Feb 8 '17 at 13:24
Documentation becomes important when it is evaluated and relied upon. This is definitively the most important part, lot of us hate to do documentation and generally the argument is always the same "NOBODY AIN'T GONNA READ IT/IT WON'T BE UPDATED". Which is... still too often true ?– Walfrat
Feb 3 '17 at 12:25
Documentation becomes important when it is evaluated and relied upon. This is definitively the most important part, lot of us hate to do documentation and generally the argument is always the same "NOBODY AIN'T GONNA READ IT/IT WON'T BE UPDATED". Which is... still too often true ?– Walfrat
Feb 3 '17 at 12:25
1
1
Question 3: "Do you have any examples of your past writing you can share with us, and can you discuss how you approached those?"
– keshlam
Feb 5 '17 at 5:16
Question 3: "Do you have any examples of your past writing you can share with us, and can you discuss how you approached those?"
– keshlam
Feb 5 '17 at 5:16
@Walfrat - Especially when someone agrees to a tight deadline it isn't communicated that it will get done, but at a lower quality with no documentation or testing.
– user8365
Feb 8 '17 at 13:24
@Walfrat - Especially when someone agrees to a tight deadline it isn't communicated that it will get done, but at a lower quality with no documentation or testing.
– user8365
Feb 8 '17 at 13:24
add a comment |
I myself am in a situation where I have to demonstrate that I know how to document:
I have answered a few questions on stackoverflow.com, and I believe that the way I answered these questions is a good reflection on how well I can write documentation.
I run a couple of blogs. While they need an update, I believe that they expose the quality of my technical writing pretty well.
If it's doable, ask to see current writing samples.
Back in December 1999, I successfully interviewed for a position as a marketing analyst for a high tech marketing consulting company. The core of the interview was a one-hour writing test on any technical subject. The interviewer ripped the paper out of my hand within 30 minutes - and almost gave me a paper cut - he'd seen enough, and I got my phone call the next day :)
If writing ability is important to you, I expect that you'd have filtered out those who sent you poorly written cover letters and resumes. A poorly written, poorly organized Linkedin profile is a no-no :)
edited 25 mins ago
Krinkle
1031
answered Mar 19 '15 at 10:22
Vietnhi PhuvanVietnhi Phuvan
69.8k7120256
Paper? Nobody wants to see my handwriting. My writing, I hope, is another matter.
– keshlam
Feb 3 '17 at 1:12
add a comment |
I myself am in a situation where I have to demonstrate that I know how to document:
I have answered a few questions on stackoverflow.com, and I believe that the way I answered these questions is a good reflection on how well I can write documentation.
I run a couple of blogs. While they need an update, I believe that they expose the quality of my technical writing pretty well.
If it's doable, ask to see current writing samples.
Back in December 1999, I successfully interviewed for a position as a marketing analyst for a high tech marketing consulting company. The core of the interview was a one-hour writing test on any technical subject. The interviewer ripped the paper out of my hand within 30 minutes - and almost gave me a paper cut - he'd seen enough, and I got my phone call the next day :)
If writing ability is important to you, I expect that you'd have filtered out those who sent you poorly written cover letters and resumes. A poorly written, poorly organized Linkedin profile is a no-no :)
edited 25 mins ago
Krinkle
1031
answered Mar 19 '15 at 10:22
Vietnhi PhuvanVietnhi Phuvan
69.8k7120256
Paper? Nobody wants to see my handwriting. My writing, I hope, is another matter.
– keshlam
Feb 3 '17 at 1:12
add a comment |
I myself am in a situation where I have to demonstrate that I know how to document:
I have answered a few questions on stackoverflow.com, and I believe that the way I answered these questions is a good reflection on how well I can write documentation.
I run a couple of blogs. While they need an update, I believe that they expose the quality of my technical writing pretty well.
If it's doable, ask to see current writing samples.
Back in December 1999, I successfully interviewed for a position as a marketing analyst for a high tech marketing consulting company. The core of the interview was a one-hour writing test on any technical subject. The interviewer ripped the paper out of my hand within 30 minutes - and almost gave me a paper cut - he'd seen enough, and I got my phone call the next day :)
If writing ability is important to you, I expect that you'd have filtered out those who sent you poorly written cover letters and resumes. A poorly written, poorly organized Linkedin profile is a no-no :)
edited 25 mins ago
Krinkle
1031
answered Mar 19 '15 at 10:22
Vietnhi PhuvanVietnhi Phuvan
69.8k7120256
I myself am in a situation where I have to demonstrate that I know how to document:
I have answered a few questions on stackoverflow.com, and I believe that the way I answered these questions is a good reflection on how well I can write documentation.
I run a couple of blogs. While they need an update, I believe that they expose the quality of my technical writing pretty well.
If it's doable, ask to see current writing samples.
Back in December 1999, I successfully interviewed for a position as a marketing analyst for a high tech marketing consulting company. The core of the interview was a one-hour writing test on any technical subject. The interviewer ripped the paper out of my hand within 30 minutes - and almost gave me a paper cut - he'd seen enough, and I got my phone call the next day :)
If writing ability is important to you, I expect that you'd have filtered out those who sent you poorly written cover letters and resumes. A poorly written, poorly organized Linkedin profile is a no-no :)
edited 25 mins ago
Krinkle
1031
answered Mar 19 '15 at 10:22
Vietnhi PhuvanVietnhi Phuvan
69.8k7120256
edited 25 mins ago
Krinkle
1031
edited 25 mins ago
Krinkle
1031
edited 25 mins ago
Krinkle
1031
1031
answered Mar 19 '15 at 10:22
Vietnhi PhuvanVietnhi Phuvan
69.8k7120256
answered Mar 19 '15 at 10:22
Vietnhi PhuvanVietnhi Phuvan
69.8k7120256
answered Mar 19 '15 at 10:22
Vietnhi PhuvanVietnhi Phuvan
69.8k7120256
69.8k7120256
Paper? Nobody wants to see my handwriting. My writing, I hope, is another matter.
– keshlam
Feb 3 '17 at 1:12
add a comment |
Paper? Nobody wants to see my handwriting. My writing, I hope, is another matter.
– keshlam
Feb 3 '17 at 1:12
Paper? Nobody wants to see my handwriting. My writing, I hope, is another matter.
– keshlam
Feb 3 '17 at 1:12
Paper? Nobody wants to see my handwriting. My writing, I hope, is another matter.
– keshlam
Feb 3 '17 at 1:12
add a comment |
Thanks for contributing an answer to The Workplace Stack Exchange!
- Please be sure to answer the question. Provide details and share your research!
But avoid …
- Asking for help, clarification, or responding to other answers.
- Making statements based on opinion; back them up with references or personal experience.
To learn more, see our tips on writing great answers.
Sign up or log in
StackExchange.ready(function ()
StackExchange.helpers.onClickDraftSave('#login-link');
);
Sign up using Google
Sign up using Facebook
Sign up using Email and Password
Post as a guest
Required, but never shown
StackExchange.ready(
function ()
StackExchange.openid.initPostLogin('.new-post-login', 'https%3a%2f%2fworkplace.stackexchange.com%2fquestions%2f42961%2fhow-to-select-an-applicant-with-good-documentation-skills%23new-answer', 'question_page');
);
Post as a guest
Required, but never shown
Sign up or log in
StackExchange.ready(function ()
StackExchange.helpers.onClickDraftSave('#login-link');
);
Sign up using Google
Sign up using Facebook
Sign up using Email and Password
Post as a guest
Required, but never shown
Sign up or log in
StackExchange.ready(function ()
StackExchange.helpers.onClickDraftSave('#login-link');
);
Sign up using Google
Sign up using Facebook
Sign up using Email and Password
Post as a guest
Required, but never shown
Sign up or log in
StackExchange.ready(function ()
StackExchange.helpers.onClickDraftSave('#login-link');
);
Sign up using Google
Sign up using Facebook
Sign up using Email and Password
Sign up using Google
Sign up using Facebook
Sign up using Email and Password
Post as a guest
Required, but never shown
Required, but never shown
Required, but never shown
Required, but never shown
Required, but never shown
Required, but never shown
Required, but never shown
Required, but never shown
Required, but never shown
3
If you want to know if they are a documentation freak ask them "How do you feel about writing documentation". If they like writing documentation they will tell you.
– paparazzo
Mar 19 '15 at 13:13
The documentation role is more that of a business / systems analyst than of an engineer. Perhaps you should recruit for a combination position.
– Wesley Long
Mar 19 '15 at 16:12
@Wesley - If you aren't willing to do the documentation then you really shouldn't be calling yourself an engineer. Developer maybe, but certainly not engineer which implies a bit higher degree of professionalism.
– Dunk
Mar 19 '15 at 20:22
@Dunk - Respectfully, I disagree. An engineer's role is to develop solutions, and to document their own work. It is not their role to document the work and systems of others. That is what business analysts and technical writers do. That's the reason these positions exist.
– Wesley Long
Mar 19 '15 at 20:23
@Wesley - As long as you agree that an engineer's role includes documenting at least their own work then I'm ok with that.
– Dunk
Mar 19 '15 at 20:59