ProjectEvergreen / greenwood

Greenwood is your workbench for the web, embracing web standards from the ground up to empower your stack from front to back.
https://www.greenwoodjs.io
MIT License
96 stars 9 forks source link

Website redesign, branding, and long term structure #978

Open thescientist13 opened 2 years ago

thescientist13 commented 2 years ago

Discussed in https://github.com/ProjectEvergreen/greenwood/discussions/503

Originally posted by **thescientist13** April 3, 2021 As we plan for the next set of features to get Greenwood to a [1.0 release](https://github.com/ProjectEvergreen/greenwood/issues/418) it would be to start discussing some related issues around structure, navigation, discoverability, and design. Some previous related issues on this topic were - #325 - #112 - #268 Some things we would like to consider are: 1. Tell a better story on the home page, with code snippets of newer features like SSR / hybrid rendering, API routes, Adapters, etc (from zero to hero as it were). Including a showcase here would be nice 1. Re-org of docs - too many clicks to get around, sections like Frontmatter and Markdown could probably be consolidated 1. Rebrand / theme the whole website (new logo at least) - we got a new logo - #1094 1. Start tracking deprecations providing more idiomatic choices / duplication of overlapping concepts 1. I think its time to decouple the website from the monorepo. This would also let us re-evaluate our release branching / merging strategy, since commits wouldn't be tied to automatic documentation deployment. ---- Tracking tasks for when the website repo is ready to be cutover too 1. [ ] Workspace changes - delete www from workspace - switch to npm and update GitHub actions - remove odd rollup bundling work around - https://github.com/ProjectEvergreen/greenwood/discussions/623 - https://github.com/ProjectEvergreen/greenwood/blob/v0.30.0-alpha.1/packages/cli/src/config/rollup.config.js#L77 - revisit linting / config files - https://github.com/ProjectEvergreen/www.greenwoodjs.dev/issues/24 - conventional commits - update issue templates - update actions (remove master / release actions) 1. [ ] Refresh README.md 1. [ ] Refresh contributing.md - https://github.com/ProjectEvergreen/greenwood/discussions/594 - https://github.com/ProjectEvergreen/greenwood/discussions/1168 1. [ ] Review any open Greenwood issues / discussions and see if they should be updated / closed / etc - https://github.com/ProjectEvergreen/greenwood/discussions/560 - https://github.com/ProjectEvergreen/greenwood/discussions/523 (should these belong to greenwood or the website?) - https://github.com/ProjectEvergreen/greenwood/discussions/800
thescientist13 commented 1 year ago

Should probably consider E2E testing (finally) when considering going out with our "final" docs. - https://github.com/ProjectEvergreen/greenwood/discussions/560

thescientist13 commented 1 year ago

After reviewing the initial design for the #1094 , some good discussions around rethinking parts of the website came up

  1. Consider making more space on the home page by moving the new Greenwood logo banner up into the corner
  2. We should brainstorm what elements we want on the home page and what kind of users we want to make sure to connect with
    • those just looking to see what a repo looks like
    • those wanting to jump right to stackblitz (see the above) or some sort of quick(er) getting started
  3. As they say in movies, show don't tell. Perhaps a snazzy code snippet of some web standards focused code, like custom elements as pages?
  4. We could / should consider updating the "features" boxes and README since a lot of work and new features have been added since those were originally authored.

One good exercise we considered was doing a live mockup with all the elements we want, and just drag and drop them in real time. We can use it as forcing function to really understand what we care about most in terms of showing off and what to prioritize. All these items are important, unfortunately they can't all be above the fold, so we'll have to pick something, and ideally that also works well on mobile to make sure we retain the "above the fold" experience.

thescientist13 commented 10 months ago

For anyone following along, please feel free to get involved in some discussions i've started for the new website. ✌️