fleetdm / fleet

Open-source platform for IT, security, and infrastructure teams. (Linux, macOS, Chrome, Windows, cloud, data center)
https://fleetdm.com
Other
3.17k stars 434 forks source link

Request: Support page osquery highlight #15212

Open spokanemac opened 1 year ago

spokanemac commented 1 year ago

This request is expected to be doable in ≤1 sprint. It would be valuable even if nothing else ships.

It will be reviewed by the acting PM for the #g-website product group, and then hopefully prioritized, drafted, and implemented.

Goal

Link to osquery Slack section of the Support page from chat and elsewhere using https://fleetdm.com/support#osquery so users are scrolled down (esp. on mobile) to the osquery Slack support card. Bonus points for recognizing the anchor and highlighting the support card to draw attention further.

User story
As a user looking for support,
I want to have my attention focussed on the osquery Slack option
so that I can get support from the community.

For help creating a user story, see "Writing a good user story" in the website handbook.

Changes

This issue's estimation includes completing the following:

QA

The testing steps outlined below must be verified before the associated PR is merged. See "Quality" in the website handbook for help.

Manual testing steps

  1. Step 1
  2. Step 2
  3. Step 3

In addition to the steps above, ensure changes have been checked at all breakpoints, and a browser compatibility test has been carried out on supported browsers.

Testing notes

mike-j-thomas commented 1 year ago

Hey @spokanemac, I just want to make sure that I understand this correctly. Is the URL that you referenced a link that you often send to folks? If so, then you are requesting a kind of magic link that directs the folks you send it to to the correct place to click.

spokanemac commented 1 year ago

The idea is to refer a community member to seek support on the osquery Slack without directly linking to the osquery Slack (b/c that is even more confusing). For example, on mobile, if we send them to the support page, they see the top of the page (and might not realize they need to scroll down). We don't have an anchor on the page to get them down to the Slack section (2nd screenshot). It'd be nice to highlight that area on the desktop to draw focus to it.

mike-j-thomas commented 1 year ago

The idea is to refer a community member to seek support on the osquery Slack without directly linking to the osquery Slack (b/c that is even more confusing).

@spokanemac, that was going to be my next question. Why not just update the chat (and wherever else you plan to send the link from) to point to https://chat.osquery.io/c/fleet? Why do you consider that more confusing (aside from Linen being a little unclear about where a user participates in a conversation)?

mike-j-thomas commented 11 months ago

@spokanemac, I'm looking at this again. Where do we link users to the Slack channel from? In other words, where will users be coming from when we scroll to and highlight the Slack section of the support page?

spokanemac commented 11 months ago

Where do we link users to the Slack channel from? In other words, where will users be coming from when we scroll to and highlight the Slack section of the support page?

@mike-j-thomas Users could be coming from chat, or other direct links in a follow-up email urging users to join the Slack community. Being able to give an anchor to /support#osquery or /support#slack or something similar would help bring focus to the section of the support page about the Slack communities. I would put the anchor just before Ask the community.