corona-warn-app / cwa-documentation

Project overview, general documentation, and white papers. The CWA development ends on May 31, 2023. You still can warn other users until April 30, 2023. More information:
https://coronawarn.app/en/faq/#ramp_down
Apache License 2.0
3.28k stars 344 forks source link

Contact Journal information not updated to 15 days #527

Closed MikeMcC399 closed 2 years ago

MikeMcC399 commented 3 years ago

Avoid duplicates

Technical details

Describe the bug

The Contact Journal Information says:

"Create an overview of your contacts in the last 14 days, so you’ll have a complete list at hand quickly if needed."

however since version 1.12.0 the number of days stored by the Contact Journal has been increased from 14 to 15 days. Version 1.11.0 stored 14 days.

Keep track of your contacts

Steps to reproduce the issue

  1. Tap "Journal" at bottom of screen
  2. Note text "Create an overview of your contacts in the last 14 days, so you’ll have a complete list at hand quickly if needed." if this is the first time using the journal
  3. Tap "OPEN JOURNAL"
  4. If not the first time using, tap three-dot icon > Information and read text as noted in (2.) above.
  5. In three-dot icon, tap Export Entries
  6. Select Save to Drive, Save or use other sharing method
  7. Read exported text "Kontakte der letzten 15 Tage ..."
  8. To verify there are 15 days stored, examine the Contact Journal

Edit: Steps updated for changed UI in 1.13.2

Expected behavior

The text "Create an overview of your contacts in the last nn days ..." should correspond to the number of days stored, which is 15.

Possible Fix

Modify values\contact_diary_strings.xml String contact_diary_onboarding_body to "Create an overview of your contacts in the last 15 days ..."

and other supported languages accordingly.

Additional context

The increase in the number of days stored in the Contact Journal updating from 1.11.0 to 1.12.0 from 14 to 15 days is not mentioned in the New Features / Release 1.12.0. Viewable through three-dot icon > New Features.


Internal Tracking ID: EXPOSUREAPP-5156 Internal Tracking ID: EXPOSUREAPP-10331

dsarkar commented 3 years ago

@MikeMcC399 thanks, actually same issue on iOS. Transferring to doc repo.

dsarkar commented 3 years ago

Internal Tracking ID: EXPOSUREAPP-5156

andjeraj commented 3 years ago

Avoid duplicates

  • [x] Bug is not mentioned in the FAQ

  • [ ] Bug is specific for Android only, for general issues / questions that apply to iOS and Android please raise them in the documentation repository

  • [X] Bug is not already reported in another issue

Technical details

  • Device name: Samsung Galaxy A5 (2017) SM-A520F

  • Android version: 8.0.0

  • App version: 1.12.0

Describe the bug

The Contact Journal Information says:

"Create an overview of your contacts in the last 14 days, so you’ll have a complete list at hand quickly if needed."

however since version 1.12.0 the number of days stored by the Contact Journal has been increased from 14 to 15 days. Version 1.11.0 stored 14 days.

Keep track of your contacts

Steps to reproduce the issue

  1. Scroll down to Contact Journal and tap "MANAGE JOURNAL"

  2. Note text "Create an overview of your contacts in the last 14 days, so you’ll have a complete list at hand quickly if needed." if this is the first time using the journal

  3. Tap MANAGE JOURNAL

  4. If not the first time using, tap three-dot icon > Information and read text as noted in (2.) above.

  5. In three-dot icon, tap Export Entries

  6. Select Save to Drive, Save or use other sharing method

  7. Read exported text "Kontakte der letzten 15 Tage ..."

  8. To verify there are 15 days stored, examine the Contact Journal

Expected behavior

The text

"Create an overview of your contacts in the last nn days ..." should correspond to the number of days stored, which is 15.

Possible Fix

Modify values\contact_diary_strings.xml

String contact_diary_onboarding_body to

"Create an overview of your contacts in the last 15 days ..."

and other supported languages accordingly.

Additional context

The increase in the number of days stored in the Contact Journal updating from 1.11.0 to 1.12.0 from 14 to 15 days is not mentioned in the New Features / Release 1.12.0. Viewable through three-dot icon > New Features.


Internal Tracking ID: EXPOSUREAPP-5156

MikeMcC399 commented 3 years ago

@andjeraj Your post is a copy of the original report. Were you trying to add some information? If not, then perhaps you could delete your post as it looks like it was an accident.

dsarkar commented 3 years ago

@MikeMcC399 Feedback:

This is the expected behavior. It shows correctly 14 days and additionally the current day. This was extended by one day as in the risk-history it is the same behavior (14 days + current day.

MikeMcC399 commented 3 years ago

@dsarkar

This is the expected behavior. It shows correctly 14 days and additionally the current day. This was extended by one day as in the risk-history it is the same behavior (14 days + current day.

It just seems slightly inconsistent and confusing if in one place it says you can create an overview for 14 days and in another place it says that you are sharing the last 15 days.


Keep track of your contacts


Share 15 Tage


MikeMcC399 commented 3 years ago

@dsarkar When I revisited this issue I noticed that the Contact Journal onboarding / information screen is inconsistent on the same page. 14 days needs to be changed to 15 days. It says lower down that "Journal entries will be deleted automatically after 16 days.". That only makes sense together with a value of 15 days to keep entries active, not 14 days.

Keep track of your contacts

dsarkar commented 3 years ago

@MikeMcC399 ok, I will forward this info to the internal ticket.

MikeMcC399 commented 3 years ago

@dsarkar We didn't hear anything more back from you on this topic. In the screen from https://github.com/corona-warn-app/cwa-documentation/issues/527#issuecomment-815884939 the numbers only make sense if the number at the top is 14 days together with 15 days at the bottom, or 15 days at the top with 16 days at the bottom.

Keep track of your contacts

If we can't agree about this, then I suggest that this issue is closed. It's all about whether the current day is counted or not, and I think that it is confusing in the text if the current day is not included at the top, but it is included at the bottom. Taken together with the export date, the app is naming 14 days, 15 days and 16 days all for the same thing.

dsarkar commented 2 years ago

Internal Tracking ID: EXPOSUREAPP-10331

MikeMcC399 commented 2 years ago

@dsarkar This issue has the label Fix 2.14, however I cannot see any change.

I can't see any reference to EXPOSUREAPP-10331 anywhere else.

Was any change actually done, and if yes, what was the change?

MikeMcC399 commented 2 years ago

@dsarkar This issue is still unresolved. I would submit a PR to fix it, but that is not recommended for translated text and I would only do it for Android, not for iOS.

For Android the fix would be in values-de/contact_diary_strings.xml#L34-L35

Change contact_diary_onboarding_body

"Erstellen Sie eine Übersicht über Ihre Kontakte der letzten 14 Tage. ..."

to

"Erstellen Sie eine Übersicht über Ihre Kontakte der letzten 15 Tage. ..."

Other languages, including English would get changed through the translation process.

That would make it consistent with the text displayed on the same view values-de/contact_diary_strings.xml#L42-L43

contact_diary_onboarding_functionality_fourth_section

"Sie können hinzugefügte Personen und Orte jederzeit wieder aus dem Tagebuch löschen. Tagebuch-Einträge werden nach 16 Tagen automatisch gelöscht."

and with the text values/contact_diary_strings_export.xml#L10-L11

contact_diary_export_intro_one

"Kontakte der letzten 15 Tage (%1$s - %2$s)"

which is used by the export entries function.

MikeMcC399 commented 2 years ago

No change to this issue with label "Fix 2.15".

Checked on CWA Android 2.16.2.

Keep track of your contacts

Ein-Tim commented 2 years ago

I'm planning to provide a PR for this under iOS.

I would do the following changes:

"Erstellen Sie eine Übersicht über Ihre Kontakte der letzten 15 Tage. So haben Sie bei Bedarf schnell eine vollständige Liste zur Hand. Zusätzlich werden Ihnen hier Ihre Risiko-Begegnungen angezeigt."

and

"Sie können hinzugefügte Personen und Orte jederzeit wieder aus dem Tagebuch löschen. Tagebuch-Einträge werden nach 15 Tagen automatisch gelöscht."

Do you agree with this @MikeMcC399?

MikeMcC399 commented 2 years ago

@Ein-Tim

The 14 days in the text "Erstellen Sie eine Übersicht über Ihre Kontakte der letzten 14 Tage. ..." is definitely wrong. It contradicts the fact that there are 15 days visible in the Contact Journal. It should be changed to 15 days and I don't know why this has not already been done.

The days in this text should be the same as the value defined in https://github.com/corona-warn-app/cwa-app-android/blob/release/2.16.x/Corona-Warn-App/src/main/java/de/rki/coronawarnapp/contactdiary/ui/overview/ContactDiaryOverviewViewModel.kt#L369-L372

    companion object {
        // Today + 14 days
        const val DAY_COUNT = 15
    }

I believe that the 16 days in the following text is right and should not be changed. A developer should be consulted if you think this is wrong.

"Sie können hinzugefügte Personen und Orte jederzeit wieder aus dem Tagebuch löschen. Tagebuch-Einträge werden nach 16 Tagen automatisch gelöscht."

In Android there is a parameter which defines how old entries are deleted:

https://github.com/corona-warn-app/cwa-app-android/blob/release/2.16.x/Corona-Warn-App/src/main/java/de/rki/coronawarnapp/contactdiary/retention/ContactDiaryRetentionCalculation.kt#L74-L79

    companion object {
        /**
         * Contact diary data retention in days 15+1
         */
        const val RETENTION_DAYS = 16
    }

Looking at the code it seems that 16 full days need to have elapsed before a contact journal entry is deleted, so an entry from Jan 1 would be deleted on Jan 18.

On Jan 18 the contact journal would be displaying Jan 4 to Jan 18 data inclusive. Data for Jan 2 and 3 is still stored but not displayed.

Ein-Tim commented 2 years ago

@MikeMcC399

Ah, I see. Mh, to me it makes no sende that contact journal entries are stored longer than they are displayed.

Well, I think I'll first wait for feedback then.

MikeMcC399 commented 2 years ago

@Ein-Tim

It is all a little unclear. The contact journal displays today and the previous 14 days making a total of 15 days. The text could be better worded to use the value 15 days unambiguously, for instance "Erstellen Sie eine Übersicht Ihrer Kontakte über einen Zeitraum von 15 Tage." or "Erstellen Sie eine Übersicht über Ihre Kontakte von heute und den vergangenen 14 Tagen.".

Keeping a full 16 days stored may make sense to ensure no needed data is lost if the time zone is changed, but I am guessing about the reason.

Ein-Tim commented 2 years ago

Android PR: https://github.com/corona-warn-app/cwa-app-android/pull/4725 iOS PR: https://github.com/corona-warn-app/cwa-app-ios/pull/4111

Is this better @MikeMcC399?

MikeMcC399 commented 2 years ago

@Ein-Tim

The simple change of 14 days to 15 days is fine.

This agrees also with the export entries text, which says "Kontakte der letzten 15 Tage".

MikeMcC399 commented 2 years ago

@dsarkar

I checked CWA Android 2.17.1-RC0 and the text has been changed to 15 days in English and German.

Perhaps @Ein-Tim could check the iOS release candidate as well? If iOS has also been successfully corrected you could update the label of this issue to Fix 2.17.

Ein-Tim commented 2 years ago

@MikeMcC399

I confirmed that my PR https://github.com/corona-warn-app/cwa-app-ios/pull/4111 is part of the 2.17.0-RC3.

Also, building the project locally shows the fixed text on the emulator. This should get fixed in version 2.17.x under iOS.

MikeMcC399 commented 2 years ago

This was fixed in CWA 2.17.2. The label Fix 2.14 is incorrect.

dsarkar commented 2 years ago

@MikeMcC399 Thanks!