some errors on user-research/guidelines/

added Community UX labels

assigned to @nah

@nah could you take a look to this content?

YES! Thanks!

changed the description

assigned to @duncan and unassigned @nah

added Next label

changed due date to May 24, 2021

I'll take a look on Monday :)

@emmapeel I've spotted some other things I'd like to fix while I'm in the file, but is that going to frustrate our translators? i.e. should I just fix the bits you've pointed out, or can I do a full proofread?

Thanks!

I think we need to make the strings as best as possible. That should happen before they get on the website, but if not, we should fix them anyway.

Anyway, the community portal does not have many translations yet, so we are not bothering so many people.

For next texts, it would be better if we can review the texts before publishing.

Got it, ty!

mentioned in merge request !78 (merged)

Okaydokes, I've started a tidy-up of the page and have an MR in progress here: !78 (merged)

There was some text that seemed a little out of order or repeated itself between sections, so I've had to do a bit of chopping and changing.

I noticed in this commit (2b157385) @gus broke some sentences onto their own lines to help with l10n. Is that a format I should be following everywhere? i.e. Should all sentences should be on their own line, with new paras indicated by double line breaks? And is there a preference for one or two line breaks after a heading?

"Get in here to read some suggestions about being a better listener and make a great research experience." - but there is no link. where should the reader get ?

I've just removed this line as I'm not sure where it should point to. Any ideas @antonela?

in the section "Describe and Ask for consent" we have an empty link in "You should take [this material] with you on the day of your research, distribute it among participants, and answer their questions about how to fill it in if they have any." - This material does not link anywhere.

Likewise, I can't seem to find the consent form in the UX repo?

in the section 'How to submit your findings' we say on the 3rd point: Create issues in the Research repository. The research repository links to the readme file. Maybe we should change the link to https://gitlab.torproject.org/tpo/ux/research/-/issues, and say to create an issue on the Research project instead of repository? In other page we say: "After choosing which study to run, open an issue in our GitLab page."

Done!

Last Q: our guidelines currently say "you can record if you wish", however would we rather caution user researchers against recording interviews entirely?

Thanks and sorry for all the questions!

I noticed in this commit (2b157385) @gus broke some sentences onto their own lines to help with l10n. Is that a format I should be following everywhere? i.e. Should all sentences should be on their own line, with new paras indicated by double line breaks?

Yes, this is important for l10n. Please read: https://gitlab.torproject.org/tpo/web/tpo/-/wikis/Writing-the-content regarding this and other details.

And is there a preference for one or two line breaks after a heading?

Not yet. I personally think we should have one line, and have the CSS decide on the size of it.

I've just removed this line as I'm not sure where it should point to. Any ideas @antonela?

It's good. Lets remove it for now.

Likewise, I can't seem to find the consent form in the UX repo?

I believe @nah is referring to the content of the page, so the link can be removed. If not, @nah could you link there the consent form?

Last Q: our guidelines currently say "you can record if you wish", however would we rather caution user researchers against recording interviews entirely?

Good question. We used to record voice locally after asking for consent, but that material got destroyed after the reporting. Maybe a line to mention how information should be handled is not enough so we can discourage recording.

Likewise, I can't seem to find the consent form in the UX repo?

I believe @nah is referring to the content of the page, so the link can be removed. If not, @nah could you link there the consent form?

Just added a consent form here. @duncan Can you do a proofreading on it, before linking to the page?

Last Q: our guidelines currently say "you can record if you wish", however would we rather caution user researchers against recording interviews entirely?

Good question. We used to record voice locally after asking for consent, but that material got destroyed after the reporting. Maybe a line to mention how information should be handled is not enough so we can discourage recording.

Agreed. I also added in the consent form that the UX Researcher won't upload any notes and recordings to third-party clouds/services.

removed due date

Thanks all! I've just removed the reference to recording for now.

Would you mind reviewing the draft MR from a content/l10n perspective @antonela/@emmapeel, and suggest any changes that need made?

!78 (merged)

I'll proofread the consent form too, thanks @nah!

added Doing label and removed Next label

added Needs Review label and removed Doing label

removed Needs Review label

added Next label

mentioned in commit 74d056a9

ok, fixed with duncan's MR and pushed with 74d056a9

closed

some errors on user-research/guidelines/

Designs

Child items ...

Activity