Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Request: Add docs navigation panel to /guides #22037

Closed
Drew-P-drawers opened this issue Sep 12, 2024 · 7 comments · Fixed by #22992
Closed

Request: Add docs navigation panel to /guides #22037

Drew-P-drawers opened this issue Sep 12, 2024 · 7 comments · Fixed by #22992
Assignees
Labels
#g-digital-experience https://fleetdm.com/handbook/digital-experience

Comments

@Drew-P-drawers
Copy link
Contributor

Drew-P-drawers commented Sep 12, 2024

Goal

Create a path with minimum resistance to get site visitors back to /docs or /guides more easily.
There's not an not an easy path to follow through articles and guides.

Reasoning

With an influx in content through /guides we have just as many engaged sessions on the site as a whole, but the journey has shifted. When we had more traffic in docs, we had more people hitting the /deploy pages. Now that traffic is increasing in /guides, we have less people hitting the /deploy page because they don't see the big picture of /docs anymore.

image.png

Changes

Figma: https://www.figma.com/design/3he8e72251IEnF6dBafKq1/%F0%9F%9A%A7-fleetdm.com-(scratchpad)?node-id=16298-5693

@Drew-P-drawers Drew-P-drawers added the #g-digital-experience https://fleetdm.com/handbook/digital-experience label Sep 12, 2024
@mike-j-thomas
Copy link
Member

Thanks, @Drew-P-drawers; I've already been drafting something similar to solve this. Thanks for sending the digging up the data that backs up my hunch.

@mike-j-thomas
Copy link
Member

To start with, we were planning to add breadcrumbs and search to the guide template (#15857). That will at least help users navigate, especially if they have arrived via a shared article or Google search. Also considering putting a CTA for the docs and deploying on the guides template rather than just adding the docs sidenav.

@mike-j-thomas
Copy link
Member

@Drew-P-drawers, has the merging of #15857 (breadcrumbs) and #21850 (search) helped any with this?

I have a wireframe drafted (linked in the description) that I think is a good UX improvement. What I'm missing is certainty that now is the right time to add this to Eric's plate.

We can at least get an idea of an estimate from @eashaw based on the proposed changes before bringing it to design review.

@mike-j-thomas
Copy link
Member

cc @Sampfluger88 ⬆️ (forgot to tag you above)

@nonpunctual
Copy link
Contributor

related: #16713

@mike-j-thomas
Copy link
Member

@eashaw, this has been through design review and is ready for you 👍
Please also include #21281 as part of this.

@eashaw eashaw assigned eashaw and unassigned mike-j-thomas Oct 16, 2024
mike-j-thomas added a commit that referenced this issue Oct 18, 2024
Closes: #22037
Closes: #21281

Changes:
- Added a sidebar nav to article pages with 
   - links to headings (h2) in the article
   - links to /guides, /docs, and the REST API documentation
   - links to share the article on Twitter, LinkedIn, and Hacker News.

---------

Co-authored-by: Mike Thomas <[email protected]>
@fleet-release
Copy link
Contributor

Navigation panel shines,
Guides and docs intertwined,
Clear path, users find.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
#g-digital-experience https://fleetdm.com/handbook/digital-experience
Projects
None yet
Development

Successfully merging a pull request may close this issue.

5 participants