SEO & Optimization Handbook

How we approached Search Engine Optimization and site optimisation: structure, content, technical hygiene, link earning and measurement, treated as part of web engineering rather than as tricks.

This handbook is part of the Dianthos Web Engineering Handbook and reflects practices used in real projects between 2003 and 2018, focusing on durable principles over short-term tactics.

← Back to the Web & IT Handbook overview

SEO as part of web engineering

SEO was never treated as a separate, mysterious activity. In the Dianthos approach it was simply the discipline of making websites understandable, technically sound and valuable for both users and search engines.

This meant that SEO work touched almost every layer of a project:

  • Information architecture and internal linking.
  • Content planning, titles, headings and copy.
  • Technical details: performance, mobile behaviour, status codes, redirects.
  • Reputation signals: how and where the site was referenced elsewhere.

The objective was long-term visibility on relevant queries, not short-lived ranking spikes.

Search behaviour, intent & keyword strategy

Before changing pages, we tried to understand what people were actually looking for. Keywords were not just strings; they represented questions and intentions.

Understanding intent

  • Informational: “how to…”, “what is…”, definitions, guides.
  • Navigational: searches for a specific brand or site.
  • Transactional: searches close to a purchase or enquiry.
  • Local: searches with geographic qualifiers or local intent.

From keywords to page planning

  • Grouping related queries into themes rather than creating pages for each phrase.
  • Assigning themes to specific page types: service pages, articles, FAQs, glossaries.
  • Avoiding internal competition by clarifying which page should rank for which theme.
  • Using keyword research to refine content ideas, not to over-stuff copy.

A simple mapping document (queries → pages) often clarified the entire SEO strategy.

On-page SEO fundamentals

On-page SEO is about clarity: clear topics, clear structure, clear signals in HTML. When search engines and users see the same story, rankings tend to be more stable.

Basic elements we tuned on each key page

  • Titles (title tags). Specific, descriptive and ideally including a main keyword or phrase.
  • Meta descriptions. Concise summaries aimed at click-through, aligned with page content.
  • Headings (H1–H3). A single main heading (H1) that states the topic, with subheadings that reflect sections.
  • Body copy. Natural language that answers the user’s question, with moderate use of key terms and synonyms.
  • Images & media. Descriptive filenames, alt text where meaningful, appropriate sizes and formats.

Internally, we often treated on-page SEO as “making the page self-explanatory for a careful, automated reader”.

Site structure, internal linking & navigation

Search engines interpret a site partly through its internal links. Which pages are closest to the homepage, how sections connect, how often important pages are referenced — all of this shapes perceived importance.

Structural practices

  • Keeping the number of main sections manageable and intuitive.
  • Ensuring that key pages were reachable within a few clicks from the homepage.
  • Using breadcrumbs to clarify hierarchy for both users and crawlers.
  • Building internal links using meaningful anchor text, not generic “click here”.

We avoided excessive cross-linking that confused users. Internal links were added where they genuinely helped navigation and understanding.

Technical SEO & performance

Technical SEO ensures that search engines can crawl, index and interpret the site correctly, and that users experience it without unnecessary friction.

Crawling & indexing

  • Consistent use of HTTP status codes (200, 301, 404, 410 as appropriate).
  • Clean URL structures without unnecessary parameters where possible.
  • XML sitemaps kept in sync with important indexable pages.
  • Robots.txt configured to avoid blocking essential resources by mistake.

Performance & mobile

  • Optimising images, combining and minimising assets where reasonable.
  • Checking mobile rendering and touch behaviour on real devices.
  • Avoiding heavy, blocking scripts on critical pages.
  • Monitoring page load times for typical users, not only on local machines.

Many ranking problems disappeared when basic technical issues and slow pages were addressed.

Content strategy, evergreen material & updates

Content is central to sustainable SEO. Rather than producing large volumes of short, overlapping pieces, we preferred fewer, well-structured pages that could be updated.

Principles for SEO-oriented content

  • Start from real user questions (support emails, sales calls, search queries).
  • Group related topics to avoid creating dozens of near-duplicate pages.
  • Design “pillar” pages for core topics and supporting articles for depth.
  • Review and update high-value pages periodically instead of abandoning them.

Over time, these pages became reference points: they attracted links, supported campaigns and helped answer recurring questions.

Off-page SEO & link earning

External links (backlinks) act as recommendations. However, not all links have the same value, and not all tactics are sustainable or acceptable.

Approaches we considered acceptable

  • Creating resources genuinely useful enough for others to reference.
  • Contributing articles or case studies to relevant, reputable sites.
  • Ensuring consistent, accurate information on business directories where appropriate.
  • Collaborating with partners and organisations in ways that naturally led to links.

We avoided large-scale “link schemes”, automated submissions and tactics that primarily tried to manipulate algorithms. Experience suggested that such approaches often led to unstable results or penalties.

Measurement, reporting & realistic expectations

SEO results are slower and less directly controllable than paid campaigns. This makes measurement and expectation management crucial.

What we typically monitored

  • Organic traffic trends to key sections and pages.
  • Visibility on groups of relevant queries rather than on single “vanity keywords”.
  • Organic conversions: enquiries, sign-ups, sales originating from search.
  • Technical health indicators: crawl errors, index coverage, load times.

Communicating results

  • Emphasising that SEO is cumulative and influenced by many external factors.
  • Distinguishing between changes caused by on-site work and broader algorithm updates.
  • Explaining that not every ranking change is meaningful for business outcomes.
  • Linking SEO activities to business metrics wherever possible.

The goal of reporting was understanding and decision support, not producing impressive charts for their own sake.

Common pitfalls & sustainable SEO

Many SEO problems were the result of understandable mistakes rather than bad intentions. Recognising them early helped keep projects stable.

Typical pitfalls

  • Redesigns that changed URLs without proper redirects.
  • Content migrations that dropped important pages or degraded structure.
  • Overuse of automatically generated or thin pages.
  • Chasing algorithm updates with frequent, reactive changes.

A sustainable approach

  • Design sites around users and content, with SEO as a constraint and lens.
  • Maintain technical hygiene and performance as ongoing tasks.
  • Invest in a library of genuinely helpful content.
  • Build relationships and reputation in relevant communities and sectors.

From this perspective, SEO becomes a natural consequence of good web engineering and communication, not an isolated speciality.