Skip to content

First swing at persona page re-org#329

Merged
samajammin merged 23 commits into
devfrom
persona-reorg
Nov 8, 2019
Merged

First swing at persona page re-org#329
samajammin merged 23 commits into
devfrom
persona-reorg

Conversation

@samajammin
Copy link
Copy Markdown
Member

@samajammin samajammin commented Oct 21, 2019

Description

Restructure homepage & site navigation around 3 core users: individuals, developers & enterprise

Related Issue

#328

Screenshots (if appropriate):

persona-reorg

Checklist:

  • I have read the contributing guidelines in the project README.
  • My code follows the code style of this project.
  • My change requires a change to the documentation.
  • I have updated the documentation accordingly.

@samajammin samajammin added the Status: In Progress Work is in progress label Oct 21, 2019
@samajammin
Copy link
Copy Markdown
Member Author

Simple first swing at this, feedback welcome. Changes apply to English only.

  • Move /beginners to /what-is-ethereum
  • Add /individuals (a combination of /use and /learn content)
  • Update site navigation
    • Remove /beginners, /use & /learn
    • Add /individuals & /enterprise
  • Update homepage
    • Remove /beginners, /use & /learn sections
    • Add /individuals section
    • Add button link to /what-is-ethereum

cc @jjmstark

@jjmstark
Copy link
Copy Markdown
Contributor

jjmstark commented Oct 21, 2019

I was imagining an even simpler change to the existing structure & content, where we keep most of the pages as they are (for now), and simply re-organize them into our new top-level structure.

Here's how I think this first PR should work:

The three top-level personas (Individuals, Developers, Enterprise) have top-bar menu items, and each has a dropdown menu on mouseover that reveals the pages within that category:

Individuals

  • What is Ethereum? (Same content as /Beginners, but with new title)
  • Use Ethereum (Same content as /Use)
  • Guides & Resources (Same content as /Learn)

Developers

  • Get started (our new getting started page)
  • Ethereum Studio (link to our new studio)
  • Developer Resources (same content as /Developers)

Enterprise

  • Ethereum for Enterprise

Rationale for the above

  • Yes, some existing content (Use & Learn in particular) need to be rethought - but let's introduce those changes in a separate PR from one that simply introduces a new overall structure
  • Might make sense to wait on content changes until we have a more scalable translation system in mind

Other requested changes

  • On the front page under "Individuals", the first bullet point which is highlighted should be "What is Ethereum?" and not "How does Ethereum work?"

@samajammin samajammin added content 🖋️ This involves copy additions or edits feature ✨ This is enhancing something existing or creating something new labels Oct 23, 2019
@samajammin
Copy link
Copy Markdown
Member Author

@jjmstark what about the homepage section content for "individuals"? Should it be the same as the dropdown links? i.e.

Individuals
What is Ethereum? (Same content as /Beginners, but with new title)
Use Ethereum (Same content as /Use)
Guides & Resources (Same content as /Learn)

@samajammin
Copy link
Copy Markdown
Member Author

@jjmstark updated - LMK what you think.

@github-actions github-actions Bot added Status: Review Needed translation 🌍 This is related to our Translation Program labels Oct 24, 2019
@jjmstark
Copy link
Copy Markdown
Contributor

Great! A couple notes:

  • Under the developers drop down menu, there should be 3 items in the following order: Getting Started, Ethereum Studio, and Developer Resources.
  • Yes, the bullet points you have under Individuals on the index are fine
  • Under the Developers bullet points, maybe "getting started" should link to the new Getting Started page, rather than a section of the Developer Resources page?
  • On the Developer Resources page, we should add prominent links to the Getting Started page and Ethereum Studio. Any thoughts on how to do that? The simple UI element you've added to the languages v2 (Language page v2 #333) page could be an option - maybe two of those, near top of the page?

@samajammin
Copy link
Copy Markdown
Member Author

@jjmstark thanks for the review! Agree w/ all your points & should have clarified - those are missing because the Getting Started page (#322) hasn't been merged yet. Once that's done, I can make these updates.

Would you like to merge this first, as is? Or wait until #322 is merged so I can address your comments?

@samajammin samajammin added high priority This has a high priority question ❓ Further information is requested and removed Status: Review Needed labels Oct 28, 2019
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

content 🖋️ This involves copy additions or edits feature ✨ This is enhancing something existing or creating something new high priority This has a high priority question ❓ Further information is requested Status: In Progress Work is in progress translation 🌍 This is related to our Translation Program

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants