Page MenuHomePhabricator

Improve some wordings in TWL portal interface
Open, LowPublic

Description

Hello!

Every time I go on the portal I notice that some of the small text labels could be improved. So I'd like to offer a few suggestions for improvement. Feel free to rather use any other ideas you may have!

  • In some emails: "You can view the collections you're authorized to access at My Library:" doesn't explain that My Library is a page name, so suggesting to add "page" prefix before this name.
  • In the partner filters: "Multi-step access" could clarify that we're talking about application-required access, so suggesting "Access upon application".
  • In the partner filters, the "Searchable" is not very clear that we talk about the global search engine of the Library and not the individual search forms on each partners websites. I suggest editing it to "Indexed in the Library's search engine".
  • At the bottom of the filters, the "Filter collections" doesn't explain what it filters on. As I understood, it search in title/description of partners cards. So suggesting "Search the collection descriptions".
  • In the "my applications "page, the "Renewals are either not required, not available right now, or you have already requested a renewal" wording could probably be improved to avoid the two "renewal" repetition. I suggest "It is not possible to request a renewal because it is not necessary, you have already requested one, or it is not currently available".
  • By the way, I don't understand what "Last reviewed on Aug. 31, 2025, 7:49 p.m." means on the "My applications" page, even after looking at the code. Maybe someone who knows more about this can suggest a better explanation of this label?

Event Timeline

Restricted Application added subscribers: Sadads, Aklapper. · View Herald Transcript
Priyankar22 subscribed.

Hey, I'd like to work on this task and will start updating the wording suggestions above.

This comment was removed by Priyankar22.

@Priyankar22 There's already a PR for this ticket at https://github.com/WikipediaLibrary/TWLight/pull/1537, submitted by @Framawiki so we'll probably go off that rather than yours, sorry!

Thanks for the feedback on the wording, I agree some of this should be clearer, though I think some of the proposals here are too long or don't necessarily clarify the situation.

In some emails: "You can view the collections you're authorized to access at My Library:" doesn't explain that My Library is a page name, so suggesting to add "page" prefix before this name.

How about You can view the collections you're authorized to access on your My Library page?

In the partner filters: "Multi-step access" could clarify that we're talking about application-required access, so suggesting "Access upon application".

I remember taking a long time to decide what this should be called! What if we just reword this to Application required?

In the partner filters, the "Searchable" is not very clear that we talk about the global search engine of the Library and not the individual search forms on each partners websites. I suggest editing it to "Indexed in the Library's search engine".

I see the ambiguity here, but I think the proposal is too long-winded. The current UI is:

Searchable:

  • Searchable
  • Not searchable
  • Partially searchable

We could leave this as-is, and instead add some clarifying help text, like so:

Searchable:
Whether the collection is indexed in The Wikipedia Library's search feature.

  • Searchable
  • Not searchable
  • Partially searchable

At the bottom of the filters, the "Filter collections" doesn't explain what it filters on. As I understood, it search in title/description of partners cards. So suggesting "Search the collection descriptions".

Good point, I actually want to move this search box elsewhere, because it's quite hidden away and perhaps it would be more obvious what it's for if it was, say, at the top of My Library instead of down there, but that's a separate task.

How about Search collection descriptions?

In the "my applications "page, the "Renewals are either not required, not available right now, or you have already requested a renewal" wording could probably be improved to avoid the two "renewal" repetition. I suggest "It is not possible to request a renewal because it is not necessary, you have already requested one, or it is not currently available".

I see where you're coming from but I think I prefer the original wording, even with the redundancy of the word 'renewal'.

By the way, I don't understand what "Last reviewed on Aug. 31, 2025, 7:49 p.m." means on the "My applications" page, even after looking at the code. Maybe someone who knows more about this can suggest a better explanation of this label?

This is the last time a coordinator took an action (e.g. approval) on your application. Perhaps we shouldn't have such a generic statement though and instead list e.g. Approval date? Curious about your thoughts.

Thanks for your review @Samwilson! I've updated my PR with your suggestions: https://github.com/WikipediaLibrary/TWLight/pull/1537/files

This is the last time a coordinator took an action (e.g. approval) on your application. Perhaps we shouldn't have such a generic statement though and instead list e.g. Approval date? Curious about your thoughts.

I suggest to change it to Last application approved on {{ review_date }}, keeping the "approval" wording that is used across the UI.

In the partner filters, the "Searchable" is not very clear that we talk about the global search engine of the Library and not the individual search forms on each partners websites. I suggest editing it to "Indexed in the Library's search engine".

I see the ambiguity here, but I think the proposal is too long-winded. The current UI is:...
We could leave this as-is, and instead add some clarifying help text, like so:...

Your suggestion seems to be a good solution, but I prefer to avoid adding new html element as I don't have a development environment to test the changes; it will be for another ticket.
The current PR should be ready to be merged I guess.

This is the last time a coordinator took an action (e.g. approval) on your application. Perhaps we shouldn't have such a generic statement though and instead list e.g. Approval date? Curious about your thoughts.

I suggest to change it to Last application approved on {{ review_date }}, keeping the "approval" wording that is used across the UI.

The only problem is that this status isn't only for approval, it could also be for declining the application, for example.

The only problem is that this status isn't only for approval, it could also be for declining the application, for example.

Understood, I rolled back this change from the PR. Thanks for the explanation about this one.

Great, I'm happy with the changes in the PR!