C# Interest is Interesting - clarifying instructions

Programming C#
1

I struggled to understand what “Annual Balance Update” meant until I searched and found an answer in another thread.

I take the word update to mean “difference” in this case, not the total after interest is added. I understand that others read it differently.

The name of the method might be better named something like UpdatedAnnualBalance or AdjustedAnnualBalance.

An easier way to resolve this would be to change the definition of “annual balance update” so it’s clearer what is expected.

For example:
3. Calculate the annual balance update
Implement the (static) SavingsAccount.AnnualBalanceUpdate() method to calculate the annual balance update, taking into account the interest rate.

The annual balance update is the balance of the account after the interest has been added to the balance at the end of the year.

SavingsAccount.AnnualBalanceUpdate(balance: 200.75m)
// 201.75375m

If either of the above suggestions are of interest (sorry) I would be happy to submit a PR for review.

Thoughts?

2

Updating the method name would break all existing 11,509 solutions so we should try and avoid that if possible.

csharp/exercises/concept/interest-is-interesting/.docs/instructions.md at bec2c3bd09f466a5c72e2764dc8d0772d168396b · exercism/csharp · GitHub contains an example where the annual balance is updated. We can make that more clear by putting update in front of the annual balance in the first sentence. Then it’s clear the annual balance is being updated and returned.

Blockquote
Implement the (static) SavingsAccount.AnnualBalanceUpdate() method to calculate the updated annual balance, taking into account the interest rate:

3

That’s better, thanks.

(Edited) PR submitted: Update instructions for AnnualBalanceUpdate method by donbru · Pull Request #2463 · exercism/csharp · GitHub