Hi Yilin,

I'm glad to have a new proposal so soon, thanks for your attention.


I agree with expanding the tags under the blog. Redefining tags will help
others who want to learn Apache APISIX.


As you suggested, the events page will be a blank page. The events will be
removed directly from the navigation. Maybe it is a good way. At the same
time, it is a big change and I'm not sure if we should do that.

Best Regards!

Serendipity96(https://github.com/Serendipity96)



Yilin Zeng <[email protected]> 于2021年9月17日周五 下午12:03写道:

> 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)
>

Reply via email to