Colleague pretend to need a review, but want me to do all the work
I am a senior software engineer working in a department with two teams:
- One team (model team) is responsible for the creation of forecasting models.
- The other team (my team) is responsible for the implementation of these models.
Once I complete the implementation of the model, I send the model team the software, including an internal validation report explaining clearly what calculations are implemented.
The model team is now publishing my software along with the documentation explaining the forecasting model. This sign-off request is totally legitimate as I have the expertise to confirm that the implementation coincides with the documentation.
The tricky part comes at this stage:
- The documentation is very badly written with many inconsistencies.
- Since I am doing the review, they expect me to do all the work to rewrite the documentation and correct the inconsistencies.
- Once I complete the review, they want 1-2 meetings to be sure that they understand the documentation correctly.
I don't find this situation acceptable. What is the best way to react to it?
My initial idea is to send back the documentation to the model team with a list of the biggest mistakes (with the boss in cc) and ask for an updated document before I start the review.
Are there other possible solutions?
software-industry colleagues meetings
edited Mar 22 at 19:59
Dedwards
41427
asked Mar 22 at 18:05
heinertilloheinertillo
916
add a comment |
I am a senior software engineer working in a department with two teams:
- One team (model team) is responsible for the creation of forecasting models.
- The other team (my team) is responsible for the implementation of these models.
Once I complete the implementation of the model, I send the model team the software, including an internal validation report explaining clearly what calculations are implemented.
The model team is now publishing my software along with the documentation explaining the forecasting model. This sign-off request is totally legitimate as I have the expertise to confirm that the implementation coincides with the documentation.
The tricky part comes at this stage:
- The documentation is very badly written with many inconsistencies.
- Since I am doing the review, they expect me to do all the work to rewrite the documentation and correct the inconsistencies.
- Once I complete the review, they want 1-2 meetings to be sure that they understand the documentation correctly.
I don't find this situation acceptable. What is the best way to react to it?
My initial idea is to send back the documentation to the model team with a list of the biggest mistakes (with the boss in cc) and ask for an updated document before I start the review.
Are there other possible solutions?
software-industry colleagues meetings
edited Mar 22 at 19:59
Dedwards
41427
asked Mar 22 at 18:05
heinertilloheinertillo
916
2
I have a friend who did checking of tech docs and would just keep sending them back .... Along with things like « I have highlighted all the errors on the first page as an example, you need to work through the whole document ». The trouble is, if you have done it before then you have list already...
– Solar Mike
Mar 22 at 18:08
add a comment |
I am a senior software engineer working in a department with two teams:
- One team (model team) is responsible for the creation of forecasting models.
- The other team (my team) is responsible for the implementation of these models.
Once I complete the implementation of the model, I send the model team the software, including an internal validation report explaining clearly what calculations are implemented.
The model team is now publishing my software along with the documentation explaining the forecasting model. This sign-off request is totally legitimate as I have the expertise to confirm that the implementation coincides with the documentation.
The tricky part comes at this stage:
- The documentation is very badly written with many inconsistencies.
- Since I am doing the review, they expect me to do all the work to rewrite the documentation and correct the inconsistencies.
- Once I complete the review, they want 1-2 meetings to be sure that they understand the documentation correctly.
I don't find this situation acceptable. What is the best way to react to it?
My initial idea is to send back the documentation to the model team with a list of the biggest mistakes (with the boss in cc) and ask for an updated document before I start the review.
Are there other possible solutions?
software-industry colleagues meetings
edited Mar 22 at 19:59
Dedwards
41427
asked Mar 22 at 18:05
heinertilloheinertillo
916
I am a senior software engineer working in a department with two teams:
- One team (model team) is responsible for the creation of forecasting models.
- The other team (my team) is responsible for the implementation of these models.
Once I complete the implementation of the model, I send the model team the software, including an internal validation report explaining clearly what calculations are implemented.
The model team is now publishing my software along with the documentation explaining the forecasting model. This sign-off request is totally legitimate as I have the expertise to confirm that the implementation coincides with the documentation.
The tricky part comes at this stage:
- The documentation is very badly written with many inconsistencies.
- Since I am doing the review, they expect me to do all the work to rewrite the documentation and correct the inconsistencies.
- Once I complete the review, they want 1-2 meetings to be sure that they understand the documentation correctly.
I don't find this situation acceptable. What is the best way to react to it?
My initial idea is to send back the documentation to the model team with a list of the biggest mistakes (with the boss in cc) and ask for an updated document before I start the review.
Are there other possible solutions?
software-industry colleagues meetings
software-industry colleagues meetings
edited Mar 22 at 19:59
Dedwards
41427
asked Mar 22 at 18:05
heinertilloheinertillo
916
edited Mar 22 at 19:59
Dedwards
41427
asked Mar 22 at 18:05
heinertilloheinertillo
916
edited Mar 22 at 19:59
Dedwards
41427
edited Mar 22 at 19:59
Dedwards
41427
edited Mar 22 at 19:59
Dedwards
41427
41427
asked Mar 22 at 18:05
heinertilloheinertillo
916
asked Mar 22 at 18:05
heinertilloheinertillo
916
asked Mar 22 at 18:05
heinertilloheinertillo
916
916
2
I have a friend who did checking of tech docs and would just keep sending them back .... Along with things like « I have highlighted all the errors on the first page as an example, you need to work through the whole document ». The trouble is, if you have done it before then you have list already...
– Solar Mike
Mar 22 at 18:08
add a comment |
2
I have a friend who did checking of tech docs and would just keep sending them back .... Along with things like « I have highlighted all the errors on the first page as an example, you need to work through the whole document ». The trouble is, if you have done it before then you have list already...
– Solar Mike
Mar 22 at 18:08
2
2
I have a friend who did checking of tech docs and would just keep sending them back .... Along with things like « I have highlighted all the errors on the first page as an example, you need to work through the whole document ». The trouble is, if you have done it before then you have list already...
– Solar Mike
Mar 22 at 18:08
I have a friend who did checking of tech docs and would just keep sending them back .... Along with things like « I have highlighted all the errors on the first page as an example, you need to work through the whole document ». The trouble is, if you have done it before then you have list already...
– Solar Mike
Mar 22 at 18:08
add a comment |
1 Answer
1
active
oldest
votes
Go ahead and review the document, as you have stated that it is a legitimate request on their part, but do not re-write the document or correct anything in the document. Simply point out all of the problems with the document and give them the opportunity to fix them. Send them the document with your comments/critiques and unless you normally CC the boss when doing these reviews, I would advise against it.
answered Mar 22 at 18:11
sf02sf02
9,82861740
1
This. "review" is not "edit". Point out the inconsistencies (broadly or narrowly, depending on how many there are), possibly suggest some places they could go or helpful technique for fixing them, and send it back. Their expectation does not write your task orders.
– Ben Barden
Mar 22 at 19:05
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: true,
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%2f132304%2fcolleague-pretend-to-need-a-review-but-want-me-to-do-all-the-work%23new-answer', 'question_page');
}
);
Post as a guest
Required, but never shown
1 Answer
1
active
oldest
votes
1 Answer
1
active
oldest
votes
active
oldest
votes
active
oldest
votes
Go ahead and review the document, as you have stated that it is a legitimate request on their part, but do not re-write the document or correct anything in the document. Simply point out all of the problems with the document and give them the opportunity to fix them. Send them the document with your comments/critiques and unless you normally CC the boss when doing these reviews, I would advise against it.
answered Mar 22 at 18:11
sf02sf02
9,82861740
1
This. "review" is not "edit". Point out the inconsistencies (broadly or narrowly, depending on how many there are), possibly suggest some places they could go or helpful technique for fixing them, and send it back. Their expectation does not write your task orders.
– Ben Barden
Mar 22 at 19:05
add a comment |
Go ahead and review the document, as you have stated that it is a legitimate request on their part, but do not re-write the document or correct anything in the document. Simply point out all of the problems with the document and give them the opportunity to fix them. Send them the document with your comments/critiques and unless you normally CC the boss when doing these reviews, I would advise against it.
answered Mar 22 at 18:11
sf02sf02
9,82861740
1
This. "review" is not "edit". Point out the inconsistencies (broadly or narrowly, depending on how many there are), possibly suggest some places they could go or helpful technique for fixing them, and send it back. Their expectation does not write your task orders.
– Ben Barden
Mar 22 at 19:05
add a comment |
Go ahead and review the document, as you have stated that it is a legitimate request on their part, but do not re-write the document or correct anything in the document. Simply point out all of the problems with the document and give them the opportunity to fix them. Send them the document with your comments/critiques and unless you normally CC the boss when doing these reviews, I would advise against it.
answered Mar 22 at 18:11
sf02sf02
9,82861740
Go ahead and review the document, as you have stated that it is a legitimate request on their part, but do not re-write the document or correct anything in the document. Simply point out all of the problems with the document and give them the opportunity to fix them. Send them the document with your comments/critiques and unless you normally CC the boss when doing these reviews, I would advise against it.
answered Mar 22 at 18:11
sf02sf02
9,82861740
answered Mar 22 at 18:11
sf02sf02
9,82861740
answered Mar 22 at 18:11
sf02sf02
9,82861740
answered Mar 22 at 18:11
sf02sf02
9,82861740
9,82861740
1
This. "review" is not "edit". Point out the inconsistencies (broadly or narrowly, depending on how many there are), possibly suggest some places they could go or helpful technique for fixing them, and send it back. Their expectation does not write your task orders.
– Ben Barden
Mar 22 at 19:05
add a comment |
1
This. "review" is not "edit". Point out the inconsistencies (broadly or narrowly, depending on how many there are), possibly suggest some places they could go or helpful technique for fixing them, and send it back. Their expectation does not write your task orders.
– Ben Barden
Mar 22 at 19:05
1
1
This. "review" is not "edit". Point out the inconsistencies (broadly or narrowly, depending on how many there are), possibly suggest some places they could go or helpful technique for fixing them, and send it back. Their expectation does not write your task orders.
– Ben Barden
Mar 22 at 19:05
This. "review" is not "edit". Point out the inconsistencies (broadly or narrowly, depending on how many there are), possibly suggest some places they could go or helpful technique for fixing them, and send it back. Their expectation does not write your task orders.
– Ben Barden
Mar 22 at 19:05
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%2f132304%2fcolleague-pretend-to-need-a-review-but-want-me-to-do-all-the-work%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
2
I have a friend who did checking of tech docs and would just keep sending them back .... Along with things like « I have highlighted all the errors on the first page as an example, you need to work through the whole document ». The trouble is, if you have done it before then you have list already...
– Solar Mike
Mar 22 at 18:08