Add a community page

[tisonkun]

• This closes Page is lack of meta for rendering on Twitter #18.
• This closes Find a flexible website framework to publish Engula site #19.

You can checkout the code locally and explore by mkdocs server.

Screenshot:

Investigation

TL;DR

I've tried both docusaurus, hugo, and jekyll in the weekend. After notice that mkdocs with materials can be flexibly customized. I chose to customize the theme and add the community page as well as several improvement discussed before.

Goal

In #19 (comment) I wrote:

The issue here is aimed at UI/framework however. We're not in a hurry and I'm open to do some investigations before ordering contents. Maybe finally docu is the best choice with trade-offs.

Generally, I kept these goals in mind:

• We'll finally use a full-featured frontend primary framework like docusaurus or next.js, which can natively customize arbitrary logics with frontend technology. However, it requires experienced frontend experts to handle all subtle cases.
• Thus, the framework should be easy-to-use for our current contributors, who are almost system developers.
• Although, the framework should be flexible enough so that customization can be done.

Docusaurus

Live demos:

• https://apisix.apache.org/team/
• https://inlong.apache.org/

Reasons not to use:

• Strange config settings comparing to YAML files used by mkdocs/jekyll
• The framework is heavy and somehow clumsy (Can't reference links to docs from Blog facebook/docusaurus#3250).
• JSX is too complex to use. MDX is an edge tech that isn't proven to be useful and I don't want to learn it.
• SPA (single page application) doesn't attract me.

Hugo

Live demos:

• https://www.docsy.dev/
• https://skywalking.apache.org/team/

Actually, I made a branch to adopt hugo with docsy theme and I think it's almost good to use. However, hugo's DSL is a learning burden and I don't think it's well-designed.

Jekyll

Live demos:

• https://calcite.apache.org/
• https://flink.apache.org/

Jekyll can be customized flexibly and I like its orthogonal designs of template syntax. However, I don't find a good theme to get start with, and write everything from scratch is simply unacceptable.

Mkdocs

Live demos:

• https://docs.nebula-graph.io/2.6.1/

Mkdocs has a similar template syntax with Jekyll that I can understand. And I notice how to customize materials theme. So I just use it.

Reference

Other community page examples:

• https://skywalking.apache.org/team/
• https://apisix.apache.org/team
• https://www.postgresql.org/community/contributors/

[huachaohuang]

Thanks, it looks nice locally. I don't know these things very much, so I think I just merge it then :)