Revamp Echo marketing site and documentations

[jamesli2021]

I have been using Echo for some of my projects, it's solid and robust web framework than I was expected so far!

Right now, Echo's marketing site really need to improve or I will often find it hard to present to my prospect clients when they find many other web frameworks that focus on developer experience e.g. RubyonRails, Laravel, Express, Play framework, etc.

[aldas]

@jamesli2021 could you give some example which specific parts and maybe what it should entail.

I do not know if Echo could be compared to these after mentioned frameworks (maybe only Express is comparable) because compared to them Echo ecosystem is smaller as its scope is smaller. But this does not mean that Echo website should not be improved/updated.

[jamesli2021]

Marketing Site

• Suggest add “Front-end agnostic” - Useful for Javascript/TypeScript devs.
• “Learn” instead of “Getting Start”.
• Smaller fonts, more spacing to the layouts.
• Who are the maintainers?
• Featured used by projects.

Documentations

• Need Introduction (Better onboarding).
• Better API Reference. Assume programmers at large won’t be able to understand the comments e.g. https://pkg.go.dev/github.com/labstack/echo/v4#Renderer
• Concepts (How its work).
• App Structure (CLI, Web App, API Backend, Auto generate REST APIs)
• Writing could be revise and improve new to Echo web framework.
• Dark mode improves accessibility, attention, and focus
• Smaller fonts, more spacing to the layouts.

[aldas]

Some of this needs more details because it is hard to quantify "better onboarding" statements alone. Maybe more detailed explanation how https://echo.labstack.com/guide/ could be improved.

Some of this I understand - the "why" behind. For example "Smaller fonts, more spacing to the layouts." I personally agree that "headers" separating different blocks do not stand out that much and maybe need more spacing to be able to visually quickly catch where one block ends and another starts.

p.s. https://github.com/labstack/echox is the repository for the https://echo.labstack.com/ website

[jamesli2021]

As for the https://echo.labstack.com/guide/, the first thing we would read is introduction about what Echo is, what it does, use cases, need a growing ecosystem or Echo-system, attract more sponsors.

It seems that Echo is listed under microservice framework when it can be more than that.
https://www.toul.io/most-popular-golang-frameworks/

Perhaps, embed resources in cookbook could expand on the SPA topics:
https://echo.labstack.com/cookbook/embed-resources/
The line that explain "With go 1.16 embed feature", new devs picking up Echo, does not know what embed mean or they have no idea where to research for that information.

I do have design ideas for marketing sites which is actually for V programming language but could be use for Echo. If I could contribute, if it's useful, we can discuss further.

[jamesli2021]

I really found Vue, Svelte guide and API reference layouts (design and dark mode) look pleasing to read.
https://vuejs.org/guide/introduction.html
https://svelte.dev/docs

While Alpine.js and Caddy documentations looks harder to read.
https://alpinejs.dev/start-here
https://caddyserver.com/docs/