You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@pulsar.apache.org by "zuobiao-zhou (via GitHub)" <gi...@apache.org> on 2023/07/28 08:38:25 UTC
[GitHub] [pulsar] zuobiao-zhou edited a discussion: [Doc] Earn More Featured Snippets for Pulsar Doc
GitHub user zuobiao-zhou edited a discussion: [Doc] Earn More Featured Snippets for Pulsar Doc
## Motivation
Nowadays, an increasing number of users are searching for Pulsar content online, and the **search visibility of official documentation** has become increasingly important.
In Google search result, **featured snippets** [1] appear **at the top** where usually called “**Page 0**”. Featured snippets provide **a brief text that directly answers the searcher's query**.
<img width="320" alt="0号位置" src="https://github.com/apache/pulsar/assets/61108539/54e3aee3-36bf-4b95-aebb-4fef2b489fc4">
Compared to the **19.6% click-through rate** of **all natural search results** under Featured snippet, **Featured snippet** gets about **8.6% of the click-through rate**. As you can see, Featured snippets contribute significantly to the pageview of a website.
<img width="320" alt="0号位置点击率" src="https://github.com/apache/pulsar/assets/61108539/e4b1409d-91d8-4472-84da-d6aaee946d79">
Among all SEO [2] (Search Engine Optimization) strategies, **earning a featured snippet is the primary and most effective method**.
Therefore, I would like to propose making some small modifications to the Pulsar documentation to **earn more featured snippets**, thereby **improving pageview numbers**.
## 4 main types of featured snippets
There are 4 main types of featured snippets in Google: **definition**, **table**, **unordered list**, and **ordered list**.
- **definition**
This is a text snippet designed to provide searchers with **a direct and concise definition or description**. Google typically uses a definition box to answer searches for "**what is …**"

- **table**
Google extracts data from webpages and displays it as a table.

- **unordered list**
Google uses an unordered list to display items that do not need to be arranged in a specific order.

- **ordered list**
This is a list displayed in a specific order. Google typically uses it to respond to search queries that require sequential steps.

## How to earn more featured snippets for Pulsar doc
The Pulsar doc already has a certain level of authority. By standardizing the format to make the content easily understandable by search engines, there is a high probability of generating featured snippets.
The types of featured snippets that Pulsar doc can generate typically correspond to definition, unordered list and ordered list.
By drawing on some SEO best practices and studying how other websites create featured snippets, I have summarized the techniques for generating featured snippets as follows:
- defination
Google typically uses definition boxes to answer searches for "what is (are) X". The average length of these snippets ranges from 40 to 60 words.
To generate this type of featured snippet, we need to explicitly write sentences in the document using the structure "X is (are) …" and emphasize the defining part.
- unordered list
This is a list displayed items that do not need to be arranged in a specific order.
To generate this type of featured snippet, Place each item on a separate line and precede it with a bullet point for the list.
- ordered list
This is a list displayed in a specific order, corresponds to "How to ..." type of queries.
To generate this type of featured snippet, we should use a series of summary-style subheadings in the body of the content and explicitly define each step by adding the relevant phrases like "Step 1 Step 2 Step 3 ..." or "1. 2. 3. …" before them.
[1] https://developers.google.com/search/docs/appearance/featured-snippets
[2] https://developers.google.com/search/docs/fundamentals/seo-starter-guide
GitHub link: https://github.com/apache/pulsar/discussions/20897
----
This is an automatically sent email for commits@pulsar.apache.org.
To unsubscribe, please send an email to: commits-unsubscribe@pulsar.apache.org