You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@apisix.apache.org by GitBox <gi...@apache.org> on 2022/06/09 03:52:19 UTC

[GitHub] [apisix] moonming opened a new issue, #7218: docs: add `API Gateway` keywords in English and Chinese docs

moonming opened a new issue, #7218:
URL: https://github.com/apache/apisix/issues/7218

   ### Current State
   
   only Apache APISIX, no API Gateway keyword.
   
   ### Desired State
   
   see https://github.com/apache/apisix/pull/7217


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: notifications-unsubscribe@apisix.apache.org.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


[GitHub] [apisix] navendu-pottekkat commented on issue #7218: docs: add `API Gateway` keywords in English and Chinese docs

Posted by GitBox <gi...@apache.org>.
navendu-pottekkat commented on issue #7218:
URL: https://github.com/apache/apisix/issues/7218#issuecomment-1150649673

   Quote from [itseeze.com](https://itseeze.com/blog/seo-101-everything-you-need-to-know-about-metadata/#:~:text=Include%20your%20keywords&text=Each%20page%20on%20your%20website,you%20want%20to%20rank%20for.)
   
   > It goes without saying, but do make sure you’re using your target keywords in both your page titles and your meta descriptions.
   >
   > As page titles are used by Google to rank your website, including your chosen keywords will help to boost your position in search results for these terms. Whilst meta descriptions don’t directly contribute to your ranking, any keywords in your meta description will be highlighted if they match a searcher’s query, increasing your chances of that person visiting your website.
   > 
   > Each page on your website should ideally target one specific keyword. The most important keyword should always be placed at the start of the page title, and it’s a good idea to include your brand name too where possible, as this is also a keyword that you want to rank for. 
   
   So, I guess we have to minimize the number of keywords. So, from a user viewpoint, we would ideally want them to easily find the documentation page with the web search.
   
   So, based on our current keywords, the user should be able to say, Google "How to use Apache Skywalking with APISIX" and it will hit the keyword and they can also Google "apisix skywalking plugin" and get the same page. This was my thought process when deciding the keywords.


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: notifications-unsubscribe@apisix.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


[GitHub] [apisix] juzhiyuan commented on issue #7218: docs: add `API Gateway` keywords in English and Chinese docs

Posted by GitBox <gi...@apache.org>.
juzhiyuan commented on issue #7218:
URL: https://github.com/apache/apisix/issues/7218#issuecomment-1150654698

   NOTE: For any pages, we should limit the keyword count is less than 6 (would be better than 5).
   
   We can add: `APISIX, API Gateway, xxxx`


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: notifications-unsubscribe@apisix.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


[GitHub] [apisix] juzhiyuan commented on issue #7218: docs: add `API Gateway` keywords in English and Chinese docs

Posted by GitBox <gi...@apache.org>.
juzhiyuan commented on issue #7218:
URL: https://github.com/apache/apisix/issues/7218#issuecomment-1150654876

   Keywords should have relations with the current doc/page.


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: notifications-unsubscribe@apisix.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


[GitHub] [apisix] Ajay-singh1 commented on issue #7218: docs: add `API Gateway` keywords in English and Chinese docs

Posted by "Ajay-singh1 (via GitHub)" <gi...@apache.org>.
Ajay-singh1 commented on issue #7218:
URL: https://github.com/apache/apisix/issues/7218#issuecomment-1449283350

   Hey! I Just Added The Relevant Keywords in English Docs Just Check it out.


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: notifications-unsubscribe@apisix.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


[GitHub] [apisix] moonming commented on issue #7218: docs: add `API Gateway` keywords in English and Chinese docs

Posted by GitBox <gi...@apache.org>.
moonming commented on issue #7218:
URL: https://github.com/apache/apisix/issues/7218#issuecomment-1150639723

   @navendu-pottekkat what do you think? Is this good for SEO?


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: notifications-unsubscribe@apisix.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


[GitHub] [apisix] navendu-pottekkat closed issue #7218: docs: add `API Gateway` keywords in English and Chinese docs

Posted by "navendu-pottekkat (via GitHub)" <gi...@apache.org>.
navendu-pottekkat closed issue #7218: docs: add `API Gateway` keywords in English and Chinese docs
URL: https://github.com/apache/apisix/issues/7218


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: notifications-unsubscribe@apisix.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


[GitHub] [apisix] navendu-pottekkat commented on issue #7218: docs: add `API Gateway` keywords in English and Chinese docs

Posted by GitBox <gi...@apache.org>.
navendu-pottekkat commented on issue #7218:
URL: https://github.com/apache/apisix/issues/7218#issuecomment-1150647015

   @moonming It might be a good idea. I have been adding keywords on the pages I have been re-writing. Currently, I follow this structure (for Plugins):
   
   ```yaml
   ---
   title: plugin name
   keywords:
     - APISIX
     - Plugin
     - Actual Plugin Name (Node status)
     - apisix-plugin-name
   description: This document contains information about the Apache APISIX plugin-name Plugin.
   ---
   ```
   
   Adding this front matter should give better SEO than what we have before. We did not have any metadata of the pages before—no description or keywords.
   
   In SEO terms I'm not sure if adding a general keyword like "API Gateway" will help us or hinder us. Maybe @juzhiyuan has a better idea because he has been exploring SEO recently. If we decide to add this keyword, we can add a "good first label to this issue."
   
   Our current status is shown below:
   
   ![Screenshot 2022-06-09 at 9 32 31 AM](https://user-images.githubusercontent.com/49474499/172761829-209401c9-59c4-496f-9cfa-8767c1921fb0.png)
   
   As you can see, we are in a sweet spot.


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: notifications-unsubscribe@apisix.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


[GitHub] [apisix] juzhiyuan commented on issue #7218: docs: add `API Gateway` keywords in English and Chinese docs

Posted by GitBox <gi...@apache.org>.
juzhiyuan commented on issue #7218:
URL: https://github.com/apache/apisix/issues/7218#issuecomment-1150654205

   > Google "How to use Apache Skywalking with APISIX" and it will hit the keyword and they can also Google "apisix skywalking plugin" and get the same page. This was my thought process when deciding the keywords.
   
   Agree. We may add this general keyword in the end, but we should first figure out who our visitors are and how to help them find content more easily. SEO is not `Keyword` only, and Google will consider many cases, including keyword matches, traffic on specific pages, and backlinks.
   
   I agree to add this general keyword for this issue, as it's expected in some tools indeed. 😂 


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: notifications-unsubscribe@apisix.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org