Hi Serendipity96,
I can help on this part.
> * Events: Events module does not have a dedicated tab on the nav. There
> are only 4 infomation introductions are displayed on the homepage, which is
> hard to be noticed. The content on the events page is not categorized.
>
> * Blog: Blog show too much little information, and the style is simple.
Here are a couple of problems on the Events part:
1. Release notes under Events tab are redundant. For the release notes
under Events tab, these are duplicates of those under Release tab. Since
release notes under Release tab are implemented with auto-generation, the
release notes under Events tab seems to be redundant. Thus, I recommend remove
the release notes under Events tab.
1. After removing the redundant release notes from Events tab, there are
only a few event-related documents under Events tab, which is not sufficient
enough to support a tab.
2.
Here are some problems on the Blog part:
1. Using tags to catergorize the blogs is good, but it can be better if tags
were more specifiied.
2. The current tags are in lower case, but there is a 'All' tag, started
with capitalized letter, they are not unfied.
I came up with a proposal to solve the problems above:
1. Remove redundant release notes under Events tab, keep release notes under
Release tab.
2. Move event-related documents under Events tab to Blog tab, add a new tag
'Events' in Blog tab, and tag these event-related document with 'Events' tag.
3. Update tags in Blog tab
* Specifiy tags: such as 'Events', 'Weekly Report', and 'News'
* First letter capitalized: such as: 'Practical Case', 'News', and
'Security'.
4. Change the link to Events tab on home page, to link to 'Events' tag on
Blog tab.
5. Add new tags 'User Case', 'Interview' under 'Blog' tab to be more
specifiied.
What do you think?
Regards,
Yilin
<https://github.com/yzeng25>
[https://avatars.githubusercontent.com/u/36651058?v=4?s=400]<https://github.com/yzeng25>
yzeng25 - Overview<https://github.com/yzeng25>
Add a bio. yzeng25 has 28 repositories available. Follow their code on GitHub.
github.com
________________________________
From: [email protected] <[email protected]>
Sent: Thursday, September 16, 2021 1:30 AM
To: [email protected] <[email protected]>
Subject: [DISCUSS] a new structure of Apache APISIX website
hi, community,
I found that Apache APISIX website is not very convenient, I often can't
find the content that I want. But after browsing many times, I found Apache
APISIX website is very informative.
I've also followed Apache APISIX other media and found a lot of really
great content that isn't posted on the website.
I have listed some of the problems on the website：
- Apache APISIX website modules are not clear, e.g.
* Homepage: The introduction of Apache APISIX on the homepage is not
complete. The full features are on the github readme (
https://github.com/apache/apisix).
* Events: Events module does not have a dedicated tab on the nav. There
are only 4 infomation introductions are displayed on the homepage, which is
hard to be noticed. The content on the events page is not categorized.
* Blog: Blog show too much little information, and the style is simple.
* Docs: The document structure is deep and hard to find.
* Language: There are two languages on the website, but the English and
Chinese contents are mixed together.
* There is no content under the existing modules, such as: news
- Lack of linking channels to contributors:
* Except for good first issues ，for potential and new contributors
(like me), I don't know what can I contribute.
* Contact information is hidden too deep, it is in the second level
under the tab. Or I change to Apache APISIX Github to find contact
information.
- Apache APISIX has a lot of learning materials and information, but the
website is not the most comprehensive.
I think a useful contributor site is the first step to attract
contributors. What do you think？
Based on the above problems, I came up with a solution to make Apache
APISIX website better and easier to find learning materials, and I hope
more and more people will participate in contributing to Apache APISIX. I
have drawn a prototype of the website, please take a look:
https://github.com/apache/apisix-website/issues/607.
Best Regards!
Serendipity96(https://github.com/Serendipity96)
