discuss: community review of improved apisix-website on copywriting

[1502shivam-singh]

Hi all, just finished up with my GSoC project of improving the apisix-website (Redesign and code), would be happy to receive reviews from you all, specifically on copywriting and minor issues like broken links (if any) etc.

Here is the website - https://apisix-re.netlify.app/
Just to mention, all the interactions and animations (WebGL, CSS) you see on this website are my own, implemented from scratch in code. Clarifying for the sake of copyright issues, if any.

I am open to suggestions/changes in copywriting based on reviews by the community.
Hope you like this new perspective of Apache APISIX :)

cc @juzhiyuan , @Yiyiyimu
(If you are aware of community members that might be free/willing to review please mention them, posting here as last time I posted on mailing-list it good mixed and lost with the other mails)

EDIT : For easier review of copywriting check out this PR - #477

[liuxiran]

@1502shivam-singh your redesign of our website is really cool~what particularly attracted me was the middle section of the product description and Learn from developers parts.

and it would be better to adjust the layout of the first screen or enrich the content

together with the last part of the page: Be a part of building APISIX

[1502shivam-singh]

Thanks @liuxiran for the review.
Though I see some irregularities between the actual site and the shots you have provided. For instance -
A shot of the top section -

Here that flow infographic on the right animates going down, with an interaction that a little bump follows the movement of the
mouse when hovered over that canvas.
The flow infographic in your shot appears almost non existent or blurred out 😕

GitHub invite section -

The sphere rotates and is actually interactable by mouse, you can rotate it with mouse drags. I see some misalignments in your shot in this one.

Also something I noticed -
The curved line svg appears behind APISIX's design and animates with color changes, but in your shot it appears down behind "Why APISIX".

Now for providing some perspective here, I have tried keeping a minimalistic and clean design here, given the seriousness of the product APISIX.
The flow in top section is more of a metphor to the smooth, frictionless and synchronised performance of APISIX. It's a subtle element that I came up with after alot of brainstorming on what to put there, and this made most sense to me.

Please match-up if same layout is visible to you too and whether animations and interactions are functioning or not.
Also, if you have time, could you review the text-content of the website. so as to not supply any wrong information to the viewer (I have checked myself, but more eyes are always better 😊)

[1502shivam-singh]

Might be an overkill 😅, but please bear with me on this, could you check out this recorded video of the site for matching up layout and interactions

recorded-site.mp4

[Yiyiyimu]

Nice design @1502shivam-singh! Do you mind creating a markdown version of all the text in the new design and create a not-merge PR for it. I think the text part review could be easier with that.

Some suggestions from my preference 🤣

1. the right part of the architecture graph seems a little unbalanced, since the all contents are in the upper part. Also we might could change APISIX has dynamic routing and plug-in hot loading to APISIX has dynamic routing and hot-loading plugins to keep the "adj.-n." format
   
2. Seem missing a period here: "It’s opensource and ever evolving(.) feel free to contribute". And also we need a screenshot of dashboard in higher resolution
   
3. The graph of User Flexible seems not correct. The description of it seems related to low code (the graph used in "Pluginised workflow").
4. the description here is not so correct. The high performance should come from radixtree-route-matching and also etcd, not from plugins. Also, built-in plugins and json schema is more related to convenience so apisix could be used out-of-box.
   
5. maybe we could have a button for the check us out or people might not regard it as clickable
   

[1502shivam-singh]

Nice design @1502shivam-singh! Do you mind creating a markdown version of all the text in the new design and create a not-merge PR for it. I think the text part review could be easier with that.

Woh, really nice suggestion, you would then be able to provide changes in a better way using github UI. Excellent idea, on it. Also to avoid fiasco with the actual apisix-website repo, I would make a PR on my own repo, and will share link here.

1. the right part of the architecture graph seems a little unbalanced, since the all contents are in the upper part. Also we might could change APISIX has dynamic routing and plug-in hot loading to APISIX has dynamic routing and hot-loading plugins to keep the "adj.-n." format

Okay, i guess pulling the etcd cluster little bit down to align with bottom edge APISIX block should do. Agreed with the latter.

2. Seem missing a period here: "It’s opensource and ever evolving(.) feel free to contribute". And also we need a screenshot of dashboard in higher resolution

Noted. I would say a comma maybe, but yeah i got you. On the screenshot, yeah on it, I guess compression did hurt it too much.

3. The graph of User Flexible seems not correct. The description of it seems related to low code (the graph used in "Pluginised workflow").

Hmm, i was actually referencing the dual ability of code and drag and drop of APISIX. You are right, this one actually needs copywriting changes, like to - The APISIX dashboard is flexible to the user demand, providing option to write code to create custom modules as per your needs, alongside the existing no-code toolchain

4. the description here is not so correct. The high performance should come from radixtree-route-matching and also etcd, not from plugins. Also, built-in plugins and json schema is more related to convenience so apisix could be used out-of-box.

The perspective I needed, thanks. Okay, need to modify this one. How about - Apache APISIX uses radixtree-route-matching and etcd under the hood to provide you the ability to create high speed synchronized systems. From routing to built-in plugins, all these are designed and implemented to be uber performant with the minimum latency possible.

5. maybe we could have a button for the check us out or people might not regard it as clickable

Oops missed this. Earlier I thought of a red link as usually seen elsewhere, but yeah a button seems more viable

Thanks for the detailed review, will share PR link here.

[1502shivam-singh]

Check out this PR if you want to review the copywriting - 1502shivam-singh/apisix-website-redesign#11

[Yiyiyimu]

I believe the copywriting changing all looks good to me!

Besides, maybe you could move the PR here in this repo so more people could notice that

[1502shivam-singh]

Besides, maybe you could move the PR here in this repo so more people could notice that

Done, checkout #477