[wiki] Users have expressed confusion about Step 1 about data-review

[fmarier]

Since you asked for my opinion on the colour of that fancy new bikeshed :)

(It is in markdown for easy reading of the template, but we understand bugzilla will likely render it as plain text. That's fine.)

Maybe it should just be in plaintext to start with. It's kind of annoying having to look through the table markup when people use it. It would also avoid people having to rename the file manually to .txt so that it gets displayed inline in bugzilla.

[fmarier]

Attach the completed Request Form to the bug, or paste the contents as a comment in the Issue

Personally, I'd like to discourage the "pasting into a comment" option. It makes the bug a lot noisier when there are a few iterations and it's harder to see which version of the data review request got approved. Also, it prevents us from using an r? flag.

[chutten]

Personally, I'd like to discourage the "pasting into a comment" option. It makes the bug a lot noisier when there are a few iterations and it's harder to see which version of the data review request got approved. Also, it prevents us from using an r? flag.

I tried to specify that it's specifically for an Issue instead of a bug... but maybe we shouldn't be bending over backwards to supporting a GitHub-based flow for Data Review?

[fmarier]

Yeah, we should probably encourage a Bugzilla flow as much as possible. For example, the Activity Stream puts their data review requests on Bugzilla even though they use GitHub for development. I find that easier to deal with because the Bugzilla notifications / reminders are much better.

[dbaron]

This rewording answers the questions I had about the instructions. (The other piece of confusion was the first item, saying " Create a bug using the data review bug form", which I thought both meant there was a custom form and which I thought meant that I shouldn't reuse the bug.)

[chutten]

I've made some changes.

@fmarier Want to review the diff? https://wiki.mozilla.org/index.php?title=Firefox%2FData_Collection&type=revision&diff=1201350&oldid=1200054

[fmarier]

I've made some changes.

It looks much better!

[chutten]

Alrighty, any further tweaks can come via follow-ups. Closing this bug.