Do you know how to describe the work you have done?

Last updated by Jernej Kavka (JK) [SSW] 3 months ago.See history

Clients want to know how you spend your time, and how you word it matters.

On your timesheet entries, there are a few rules you should follow on how to best explain the value you have created for the client:

  • Use standard terms to describe the work you have done E.g. 'Build', 'Investigated', 'Resolved', 'Enhanced', 'Created', 'Optimized', 'Experimented with', 'Improved' or 'Fixed'.
  • Use the word 'bug' only if it fits the definition of a bug.
  • The term 'Investigated and changed' is better than 'Fixed bug'. The word 'bug' gives the impression that the problem was solely the developer's fault, when often most fixes are to do with changes as a result of unspecified work (extra validation, extra testing or gold plating).

Fixed Bug on customer form

Figure - Bad example

Investigated and improved the validation on customer form to enable saving when Customer name is > 100 characters

Figure - Good example

  • Be specific about what you did.

    • If you create a new form, write 'Created Client form'.
    • If you are adding a button to a form write 'Client form - Added button AddNew'.
    • If you are trying to find a bug write 'Investigated error on ClientDiary form'.
    • If you fix something, write 'Resolved'.
    • If you are making something faster, write 'Optimized procClientDiary'.
    • If you are writing stored procs, write down their names.
  • Use capital letters appropriately - if it is a Proper Noun use a capital.
    E.g. "Adam Cogan", "SQL Server", "Toyota" is ok, "Website" is not.
  • Start a new line for each new detail. It makes it more readable. However, don't go overboard and take up half a page for one timesheet.
  • Use past tense e.g. 'Updated web page' rather than 'update web page'
  • Avoid abbreviations. Use 'version' rather than 'ver'
  • Avoid using "General" as a project in your timesheets
  • For public holidays, timesheets should be entered as "Leave".
  • For customers from other states, travel time is usually billable and should be recorded separately on the timesheets so that the customer is fully aware of the exact time spent travelling to/from the client site
  • Non-Billable time - If you do any work that is related to a client that you would not usually bill for (such as going to an initial meeting or travel within Sydney ), you should still enter it under that client - when it comes to invoicing time, this rate will be set to zero, but still show on the invoice, so the client has a record of all the time that was spent on their project.

Apply changes as per Tony's request for FRDCAPP

Figure: Bad example - This is an example of a bad timesheet note

'CaterPRO! Version 8.3Fixed Sales Reports (Sales Dashboard).

It now reconciles correctly with Food Sales Summary.

Fixed Function Counts (was double-counting)

Fixed DiaryTemplate UpdatesAttempt to run CaterPRO! in the old Windows 7 with Alan

Figure: Good example - Informative timesheet note

Tip: Use TimePro to avoid doubling up by using Azure DevOps commit messages that flow through to timesheets.

We open source. Powered by GitHub