Skip to content

Re-consider the navigation and browsing experience #551

Closed

Description

@GBKS

We've had several discussions (including yesterdays jam session) around how the current nav structure can be confusing at times:

  • Pages with the same names (for example, Automatic cloud backup in both Onboarding and Private key management sections)
  • Onboarding is about a very specific type of product, Private key management is about underlying tech, etc. Not always intuitive why

Examples of top-level structures:

  • BTCPay docs: main sections are User guide, Deployment and Development, with additional Explore by topic options
  • Apple Human Interface Guidelines: main sections are macOS, iOS, watchOS and tvOS, with additional Technologies options

Two starting points:

  • What content do we have, is there a better natural structure?
  • What entry points do readers want (I want to find info about onboarding UX, I want to understand how multi-key works...)

I am wondering if we should bundle Onboarding and Payment into a single mega Daily spending case study. It is pretty much a more elaborate version of the other case studies we have. I think the best way to resolve this task is by mocking things up in Figma.

Activity

  1. Bosch-0 commented on Nov 3, 2021

    @Bosch-0
    Collaborator

    I've wanted to bundle Onboarding + Payments for awhile and think this makes a lot of sense compared to the current structure - big ACK from me.

    I like the idea of having a more intuitive landing page for the guide, kind of how BTCPay docs and Apple human guidelines initial view is. Some example sections we could have displayed in a similar manner to the Apple human interface guidelines:

    • Getting started (Jumps straight to start of the guide. This would be targeted at designers new to Bitcoin and want to read the Guide from start to finish rather than jump into the meat and potatoes / practical sections of the Guide).
    • Daily spending (focuses on Lightning first, mobile, non-custodial wallet application design)
    • Savings (Focuses on multi-key, cold storage application design)
    • Resources? (For all the supplementary / underlying tech chapters)

    If we go with this structure and have the main sections of the guide essentially case studies, do we really need the Case studies chapter?

    We should also have a search as well as some suggested topics on this landing page for easier navigation.

    Another suggestion is having section headings in the sidebar nav like BTCPay has below:

    image

    I will do up some mockups for my above suggestions to explain this more clearly.

  2. added
    DesignTask is about designing something.
    DevDevelopment-focused tasks.
    on Nov 11, 2021
  3. Bosch-0 commented on Feb 21, 2022

    @Bosch-0
    Collaborator
  4. GBKS commented on Mar 16, 2022

    @GBKS
    ContributorAuthor

    We had a brainstorm session for this issue yesterday. Here are the relevant links:

    And here's a visual summary, comparing the current and proposed landing pages (this is discussed in the summary video above).

    Bitcoin design guide change summary 220314

    Next step is to run this past the community and get more feedback. We also want to have a call to invite people to share their ideas. Then we'll revise the plan again and try to implement this in logical steps (inviting feedback again with each step).

  5. changed the title [-]Re-consider top-level guide navigation[/-] [+]Re-consider the navigation and browsing experience[/+] on Mar 18, 2022
  6. moved this from Todo 📝 to In Progress 🏗️ in Bitcoin Design Guide Roadmap 🎨🎯on Mar 21, 2022
  7. GBKS commented on Mar 23, 2022

    @GBKS
    ContributorAuthor

    See milestone #15 for issues that came out of these discussions.

  8. GBKS commented on Apr 25, 2022

    @GBKS
    ContributorAuthor

    Wrapping up milestone #15 now. A few remaining issues were not completed, but instead split into new issues, or will be tackled separately in other milestones.

  9. Repository owner moved this from In Progress 🏗️ to Done ✅ in Bitcoin Design Guide Roadmap 🎨🎯on Apr 25, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    DesignTask is about designing something.DevDevelopment-focused tasks.

    Type

    No type

    Projects

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions