fecgov / fec-cms

The content management system (CMS) for the new Federal Election Commission website.
https://www.fec.gov
Other
99 stars 40 forks source link

Figure out replacement for RAD lookup tool #870

Closed noahmanger closed 7 years ago

noahmanger commented 7 years ago

So that committees can directly contact their RAD analyst, implement a way for them to look up their analyst's name and contact information.


The current RAD page has this tool: image

We were just discussing on Slack if this can be replaced with the new contact form or if it needs to be reimplemented. If it needs to be re-implemented, it can use the existing API endpoint.

Tasks:

AmyKort commented 7 years ago

@llienfec

nickykrause commented 7 years ago

I missed the Slack conversation on this, but I am just catching up on it. I'm pulling some of it in here for reference.

Pat: The contact form may be able to replace it if it can somehow returns the analyst for a particular committee? But that would have to be worked into the design. Noah: My question is around what RAD’s desired business process is. Do they want all requests to go through the form now? Or do they want to also allow direct contact? Amy: My understanding is that they'd like folks to be able to separately look up their analyst. But, llien and rhough are the experts. I don't think the form sufficiently serves both purposes.

^ So, although we have a contact form that allows users to submit questions to RAD, we're looking for a feature that allows users to look up their analyst.

Some notes on the functionality of the current tool:

@noahmanger - Question. Is there any reason we couldn't offer a typeahead in our version of this search, as we do with other committee lookup fields on beta?

noahmanger commented 7 years ago

Yep, I was imagining a typeahead implementation so that you don't need separate fields for committee ID and name.

nickykrause commented 7 years ago

Okay! I worked on this some more and chatted with folks about it today during the design pairing. Thanks, all, for your thoughts.

what we said earlier about the interactions

For documentation, I'd like to note that this artboard labeled "Draft 1" is what I shared today in the pairing meeting. We discussed the possibility of applying the filter patterns to do an on-page "search," and we realized a few things:

what I changed about the interactions

In light of that, I have tweaked the designs to Draft 2.

Note a couple of things:

Questions: (cc @jenniferthibault in particular)

  1. Does this seem to violate any existing design patterns or stretch our existing patterns too far?
  2. Does it seem useful to offer the green/red "validation messages" that we offer for filters? (see image below). I left them out because it seems like a different context to me and that the interface is not complex enough for users to need the "assist" in understanding what is happening. screen shot 2017-03-17 at 3 39 04 pm
  3. Any concerns or user needs I'm not thinking of? (maybe @llienfec will have thoughts?)

And now...where do we put it?

Outside these interaction questions, we need to sort out where to put it. In the design pairing today, we talked briefly about adding it as a "contact" section on C&C services, but...

We were running out of time in the meeting, but we asked if maybe this tool is sufficiently related to the Submit a question to RAD form to warrant living alongside it. I have mocked up what it might look like to have the RAD form and lookup tool next to each other, but...

(cc @emileighoutlaw in particular, for these placement questions)

There may be other solutions as well, but I will leave this here for people to weigh in on these changes before exploring too far.

cc @noahmanger @onezerojeremy, too, in case you want to chime in

noahmanger commented 7 years ago

👍 to the general interaction design. That looks good to me.

I think I like the placement on the contact form page. There might be a more general title for this page ("Additional support"? "Contact Reports Analysis Division"?).

The only other thing I could think would be making it a modal or something that could be triggered on any compliance page.

noahmanger commented 7 years ago

In the interest of moving this ball forward, does anyone object to starting with this on the contact form page as Nicky mocked up? That way we can make it and if it turns out people need it in more places, we can revisit?

jenniferthibault commented 7 years ago

No objections, it makes sense to group them together to me. I can see how some authorized representatives would prefer to contact their analyst directly by phone, and so would use that first and vice versa for email.

Here's a small tweak I might make to the selected committee & how to clear the form, which ties it more closely to checkbox entries and how users clear unchecked boxes in the data filters:

screen shot 2017-03-21 at 11 13 51 pm


There's something I haven't quite solved for yet, but there's a slight redundancy to me for authorized representatives here, who could either call their analyst, or be allowed to submit the form. But if you know your analyst, why might you submit a general contact and not go straight to them? I was trying to hash that out, and I think it's worth showing the early sketch, even though I was hitting a wall with what to do with the "All others" info then. Maybe it will spark ideas for other folks!

screen shot 2017-03-21 at 11 32 24 pm

llienfec commented 7 years ago

Looks amazing, all!

@jenniferthibault Your comments on redundancy brought out an interesting point - RAD hasn't done a great job of letting people know that when you submit a question through the RAD Form, your question goes to your assigned analyst (unless they are out of the office).

One request: in some of the designs above, the phone hours are listed under the analyst's name. Those are the RAD open phone line hours, but not necessarily the hours that the analyst works. We have the analysts put their hours on their voicemail to help set a committee's call-back expectation. Can we use the design where the hours are under the Reports Analysis Division header instead?

jenniferthibault commented 7 years ago

@llienfec that is so helpful! Knowing that the form goes the that committee's RAD analyst anyways helps clear up what could happen. (And yes, can definitely position the contact hours with the Division instead of the individual, if the mock up below doesn't accomplishes what you meant, let me know!)

How I understood the purpose of this page before A way to submit a question to RAD in general by form submission.

How I understand the purpose of the page now A way to find and get in touch with your analyst, either by phone or form submission.

Based on this, I replaced the Search for committee by name or ID field with the Committee name or ID field from the form below. This way, we only ask users to complete that field once, and it acts almost as a Recipient field. Users who want to use the form continue filling it out and submit. Users who want to call can end their search right there.

I also tried my hand at editing the copy at the top to make this more clear, though I assume that will need review and tweaking!

Authorized representatives If you represent a committee or another entity registered with the FEC, RAD staff can help answer your reporting questions.

Submit the form below and your committee’s RAD analyst will email you, usually within 3 business days. Or, for immediate assistance, use their provided contact information to call them by phone during business hours.

screen shot 2017-03-22 at 10 02 22 am

How do you feel about this type of change @llienfec ?

llienfec commented 7 years ago

This is an interesting change @jenniferthibault I like that it's basically saying that these two tools can be used to accomplish the same thing. Since it's a change from what we showed today, I'd need to pass it around for a little buy in if you think this is the direction we should head in. Easy to do.

If we do go this way, can you help us think of ways to make what the contact form is at the point where the contact form starts? Would people be likely to stop at getting an analyst's phone number? (I didn't word this section very well, let me know if it's confusing.)

noahmanger commented 7 years ago

I like including it on this page, but having both visible like this feels a little confusing. It makes me think it's all part of a single interaction, rather than alternative interactions.

What if we only showed one at a time, either with accordions or the side tabs like on candidate pages?

llienfec commented 7 years ago

I like that idea a lot.

jenniferthibault commented 7 years ago

I was exactly proposing to make it feel like one interaction! That's a better way to say what I was trying to explain :)

If we have time and if this is of sufficient priority in the overall theme of how folks contact the FEC, I'd favor the following approach:

If we don't have the time to go that route, or if that's not the priority right now I think my preference is to try accordions first:

Using tabs as the approach would hide the second option too much, and there's not enough content for "Find your analyst" to have its own page. DQ'd!

noahmanger commented 7 years ago

@llienfec given the option, would you prefer people call or email? If email, I like Jen's suggestion for the accordions, with the lookup featured first but closed. I'm worried we don't have the time to test and re-design, so I think picking something we feel good enough about to implement now would be good.

llienfec commented 7 years ago

@noahmanger Let's do accordions, closed call on top, open form below. We just want it to be clear that if you need immediate help, use the phone. If you don't, then use the form. I like the language we already have written for those, so as long as the time expectations are clear, I think this is great to start with (and hopefully end with).

noahmanger commented 7 years ago

Great. Thanks @llienfec . I made a fresh issue for hammering out the remaining interaction details in https://github.com/18F/fec-cms/issues/934