Commenting on Artifacts

Slides:



Advertisements
Similar presentations
MFA for Business Banking – Security Code Multifactor Authentication: Quick Tip Sheets Note to Financial Institutions: We are providing these QT sheets.
Advertisements

Version Control System (Sub)Version Control (SVN).
Improving your paper SUGGESTIONS FOR SUCCESS. Writing = Revising  Writing IS a process  This paper WILL take hard work to get a good grade (or even.
REQUESTING TRANSCRIPTS Student Training Presentation.
Quiz next week – Oct 4 (communication, feedback, presentations)
1 CA201 Word Application Collaborating with Others Week # 8 By Tariq Ibn Aziz Dammam Community college.
Chapter 6 Effective Strategies to Get the Job You Want: Interviewing Strategies Copyright Raymond Gerson.
Collaborate on Documents Microsoft Word Introduction Word 2010 makes it easy for groups of people to edit one document. You can easily edit documents.
INFO 637Lecture #101 Software Engineering Process II Review INFO 637 Glenn Booker.
Team Managers Package Indoor
The Job Hunting Cycle Test Multiple Choice/ True or False Section Version A.
Chapter 5 How are software packages developed?. What are the main steps in software project development? Writing Specifications - Analysis Phase Developing.
Working in Teams Communication Support. Communicate Effectively To be a successful team, you need to be able to communicate well together How?
Day One Every Day per lb You will have 15 minutes to work with your partner to help me solve my problem. Then you will have another 10 minutes.
CSc 171 Fall 2016 Manage It! Your Guide to Modern, Pragmatic Project Management. Johanna Rothman 1 Chapter 12 – Multisite Projects How the customer explained.
Workplace documents II:
Web Portal tricks.
Day 3: Evidence and Elaboration
Why Peer Review? Rationale #4
Persuasive Messages Module Twelve McGraw-Hill/Irwin
DELEGATION, ACCOUNTABILITY and COACHING
Week Two: Outlining Warmup:
Peer Edit.
Why Peer Review? Rationale #4
This PowerPoint can be found on my Moodle page.
Worked Examples - Incremental Software Development Worked Example
Phrases For Business English
Bad News Messages Lecture 8.
Attention Grabbing Headlines
Week 2: QUIZ RETAKE LOG INTO YOUR PERSONAL FOLDER NOW.
Mathshell in Practice Ready Made Quality Group Work 6-8
California Invention Convention
College application process
LEQ: How do I organize a response to a LEQ?
English 50 MS. lYNDE.
Writing and Feedback.
Forensic Science Unit One
Informal Quoting and author tags
What Should I Say to a Suicidal Friend?
How to Really Review Papers
4-1 Quiz The following questions are designed to help you decide how well you understand today’s lesson. Please ask me if you.
Planning for Questioning
Aha Moments Last week we talked about Aha moments. When you’re reading, authors often give you clues that the character has come to an important understanding.
Data Updates.
Professionalism 2 Day Mini-Unit.
How to write good. How to write good Background: Reading Read the papers. Then read them again. Then again. Write out the structure of the paper. If.
Make sure your child is reading lots.
Working in Groups.
4.M.NBT.05 IEEI Task.
Quality Audits, and How to Survive them
Dean of Administration
Team Skill 6 - Building The Right System Part 1: Applying Use Cases
Applying Use Cases (Chapters 25,26)
In persuasive messages, you want the reader to act upon your message
Measurement reporting in TGh
TEST TAKING STRATEGIES: Reading Strategies
Y6T2L2 Learning to reflect
Today we will understand how to add and subtract negative numbers
Time and Attendance – completing your timesheet
Substituting into expressions.
HOW TO AUDIT AND TAKE AN AUDIT
What are text structures?
Test Genre The MEAP.
WisTMP 2.0 Update Andy Heidtke, PE Statewide Work Zone Design Engineer
JAN ROOVERS ASSOCIATES, INC. Charlotte, North Carolina
Substituting into expressions.
April 27 & 28, 2011 Welcome Assigment
Y5T2L2 Learning to reflect
SAFETY + Behavior Observation.
Reflections Writer’s Workshop
Presentation transcript:

Commenting on Artifacts By: Scott Mackay Date: Fall 2009

Constructive Reviewing – by Peers Turn on “Track Changes” This will record who you are & what you edit Perform a constructive document review If something is wrong, fix it directly If you have an alternate approach, suggest it If something is missing, add it Use “comments” feature only if needed If you think something is wrong, say why you think it is wrong Help move the artifact toward completion with minimum review cycles

Non-Constructive Comments Non-Constructive comments cause delays – You need to give the information needed to take action. Examples of non-constructive comments: This is wrong, fix it immediately! I don’t think this part is right Where can I learn more about this? I can think of other ways to do this Is there a better way than this? Call me and we can discuss this Where did this data come from? That’s not how we do it today The system can’t do any of these things today I gave you that answer a few weeks ago Do not make non-constructive comments! Given the information in the example comments above, what would your next step be?

Suggest the correction or fix it Don’t present problems, recommend solutions! Determine the solution and submit (or make) the recommended change If you know the answer, don’t keep it a secret Passing the problem to other people only causes delays and can cause details to be lost (wrong solution gets implemented) If you can’t solve it, get it to the right person Do not start non-constructive actions

Right Place, Right Person Keep comments appropriate for the artifact Requirement comments go in Requirements Artifacts Analysis comments go in Analysis Artifacts Design comments go in Design Artifacts Send ‘ad hoc” comments and questions to the Author of the artifact Go to the right person first to avoid delays and un-needed intermediate steps

Classic Comments  WWYD? This use case is written entirely from the users prospective, I have know idea how it will be implemented. Please explain this to me. Miscellaneous? That could be anything! This opens Pandora’s Box! This will be tough to implement I have no comment on this Why wasn’t I asked about this earlier? The storyboard looks like a comic strip Wouldn’t this require a change? This is going to get a bunch of readers tied up in a knot. My team reviewed all 1350 requirements and found 2 to be wrong. When will these be fixed? WWYD?

Questions, Contact Information