<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">
  <channel>
    <title>DEV Community: lingwei zheng</title>
    <description>The latest articles on DEV Community by lingwei zheng (@lingwei_zheng_297dc7de04d).</description>
    <link>https://dev.to/lingwei_zheng_297dc7de04d</link>
    <image>
      <url>https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F4181780%2F9bcd9b65-cc64-477e-9488-03e11c674111.png</url>
      <title>DEV Community: lingwei zheng</title>
      <link>https://dev.to/lingwei_zheng_297dc7de04d</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/lingwei_zheng_297dc7de04d"/>
    <language>en</language>
    <item>
      <title>Why a Crawlable Tool Directory Can Still Have Content-Structure Problems</title>
      <dc:creator>lingwei zheng</dc:creator>
      <pubDate>Tue, 13 Oct 2026 09:52:10 +0000</pubDate>
      <link>https://dev.to/lingwei_zheng_297dc7de04d/why-a-crawlable-tool-directory-can-still-have-content-structure-problems-kbn</link>
      <guid>https://dev.to/lingwei_zheng_297dc7de04d/why-a-crawlable-tool-directory-can-still-have-content-structure-problems-kbn</guid>
      <description>&lt;p&gt;A website can return HTTP 200, include canonical tags, and publish a valid sitemap while still giving readers confusing information.&lt;/p&gt;

&lt;p&gt;An October 12 audit of TOOLBBS, a Chinese-language directory for cross-border ecommerce and business tools, highlighted this distinction.&lt;/p&gt;

&lt;p&gt;Disclosure: I maintain &lt;a href="https://www.toolbbs.com/" rel="noopener noreferrer"&gt;TOOLBBS&lt;/a&gt;. This article discusses findings from its public-page audit. It does not claim that any individual issue explains Google's indexing decisions.&lt;/p&gt;

&lt;h2&gt;
  
  
  The scope matters
&lt;/h2&gt;

&lt;p&gt;The sitemap listed 617 URLs. The audit successfully verified 110 sitemap URLs, including 102 tool pages, and performed additional tests on pagination, search, login, URL variants, and nonexistent addresses.&lt;/p&gt;

&lt;p&gt;The remaining bulk requests encountered a network-proxy restriction before receiving a website response. Those requests were recorded as unverified, rather than classified as website errors.&lt;/p&gt;

&lt;p&gt;This is an important detail in any audit: a failed request from your testing environment is not automatically a failed response from the origin server.&lt;/p&gt;

&lt;h2&gt;
  
  
  1. Summary cards need semantic validation
&lt;/h2&gt;

&lt;p&gt;Tool pages included cards labelled:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Suitable for&lt;/li&gt;
&lt;li&gt;Not suitable for&lt;/li&gt;
&lt;li&gt;Cost considerations&lt;/li&gt;
&lt;li&gt;Compliance considerations&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;The labels were useful, but some displayed text did not answer the corresponding question.&lt;/p&gt;

&lt;p&gt;One Etsy page showed “care instructions” as its compliance summary. Across 101 sampled pages containing these cards, 22 used identical text for the cost and compliance cards.&lt;/p&gt;

&lt;p&gt;That suggests a problem worth investigating in the summary-selection process. The audit did not inspect the PHP implementation, so it could not establish the exact code-level cause.&lt;/p&gt;

&lt;p&gt;A safer design is to store each summary explicitly:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight json"&gt;&lt;code&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"audience_summary"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="kc"&gt;null&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"cost_summary"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="kc"&gt;null&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt;
  &lt;/span&gt;&lt;span class="nl"&gt;"compliance_summary"&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="kc"&gt;null&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="w"&gt;
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;A missing value should remain missing until an editor supplies an appropriate summary. Reusing the opening paragraph may produce a populated card, but it can also produce misleading information.&lt;/p&gt;

&lt;p&gt;Useful acceptance checks include:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Does the audience card describe an audience?&lt;/li&gt;
&lt;li&gt;Does the cost card explain costs or pricing conditions?&lt;/li&gt;
&lt;li&gt;Does the compliance card describe a relevant restriction?&lt;/li&gt;
&lt;li&gt;Are two different cards repeating the same generic paragraph?&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Checking that a field is nonempty is only the first step.&lt;/p&gt;

&lt;h2&gt;
  
  
  2. Navigation links do not replace contextual links
&lt;/h2&gt;

&lt;p&gt;All 102 sampled tool-page bodies lacked links to other pages on the same website.&lt;/p&gt;

&lt;p&gt;The pages still had navigation, breadcrumbs, and recommendation modules. The finding concerned links inside the main article body.&lt;/p&gt;

&lt;p&gt;These serve different purposes.&lt;/p&gt;

&lt;p&gt;A navigation menu helps readers move between broad sections. A contextual link helps them continue a specific task: understanding a fee, configuring a service, or comparing alternatives.&lt;/p&gt;

&lt;p&gt;For a directory, useful relationships might be:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Tool overview → setup tutorial&lt;/li&gt;
&lt;li&gt;Setup tutorial → troubleshooting guide&lt;/li&gt;
&lt;li&gt;Comparison article → individual tool pages&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Add these relationships where they help the reader. There is no need to insert a fixed number of links into every article.&lt;/p&gt;

&lt;h2&gt;
  
  
  3. Recommendations should match their labels
&lt;/h2&gt;

&lt;p&gt;The homepage had separate paths for ecommerce, foreign trade, and AI users.&lt;/p&gt;

&lt;p&gt;However, the AI path recommended articles about shipping documentation and freight surcharges. Those articles could be useful elsewhere, but they did not match the purpose of that particular module.&lt;/p&gt;

&lt;p&gt;A recommendation system needs a content rule as well as a display template.&lt;/p&gt;

&lt;p&gt;For example, an AI learning path could use:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;Explicit editorial selections.&lt;/li&gt;
&lt;li&gt;Articles assigned to the relevant topic.&lt;/li&gt;
&lt;li&gt;A shorter list when suitable content is unavailable.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;Filling every slot with unrelated recent posts makes the component look complete while weakening its usefulness.&lt;/p&gt;

&lt;h2&gt;
  
  
  What this means for indexing
&lt;/h2&gt;

&lt;p&gt;These findings do not demonstrate an indexing penalty.&lt;/p&gt;

&lt;p&gt;They show that technical accessibility and editorial usefulness need separate checks.&lt;/p&gt;

&lt;p&gt;Google's &lt;a href="https://developers.google.com/search/docs/fundamentals/creating-helpful-content" rel="noopener noreferrer"&gt;helpful-content guidance&lt;/a&gt; discusses original value, clear sourcing, accuracy, and the reader's experience. Its &lt;a href="https://developers.google.com/search/docs/specialty/ecommerce/pagination-and-incremental-page-loading" rel="noopener noreferrer"&gt;pagination guidance&lt;/a&gt; explains how crawlers discover content through links.&lt;/p&gt;

&lt;p&gt;An audit should examine both layers, then use Search Console and server logs to investigate actual indexing outcomes.&lt;/p&gt;

&lt;p&gt;For a tool directory, a practical review question is: can a reader understand the summary, verify important claims, and find the next relevant step?&lt;/p&gt;

&lt;p&gt;&lt;em&gt;This draft was prepared with AI assistance, using findings from the October 12 public-page audit.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>seo</category>
      <category>webdev</category>
    </item>
  </channel>
</rss>
