From IndieWeb
(Redirected from Discoverability)
Jump to: navigation, search

Discovery is a variety of methods for finding content, websites, communities, or people to follow on the web including search, directories, recommendation engines, tags, or other serendipitous methods.

or alternately a more developer-centric definition:

Discovery for the IndieWeb is a set of algorithms to start with a URL like a home page or post permalink, and determine information about that URL, such as authorship, page-name, and date published.

User-centric definition

IndieWeb Examples

Indie Map

Microblog Discover

IndieWeb XYZ directory

Microcast Club

The Feed Directory

Search My Site

  • Search My Site - provides for browsing and searching independent websites.

IndieWeb Search

  • IndieWeb Search is a search engine that lets you find websites and web pages made by IndieWeb community members. IndieWeb Search supports featured snippets and rich results for some queries.

Curated Lists for Discovery

I followed several new to me feeds today and then decided—why not share? There may be no other way to rediscover the social network that is blogging.
Finding new blogs is a big problem so, if you like this blog you may also appreciate the following people who have all interacted with the site via webmentions

Silo Examples

  • - A daily selection of the best content published on WordPress, collected for you by humans who love to read.
  • - a website by Andy Baio that surfaces relevant links from his Twitter community
  • Twitter has a widely used #FollowFriday or #FF hashtag that people use to Tweet about friends, colleagues, and others that they find interesting to follow, generally with a short statement about why.
  • Serendeputy is a small, independently run discovery service similar to Nuzzel. It describes itself as "a personal newsfeed engine. It reads the open web and then organizes and scores it for you. It learns what you like and helps you find something interesting to read.But, here’s what’s different. Unlike your favorite search engines and social networks, Serendeputy is entirely transparent, putting you in control." Paid accounts are available to help support the developer.
  • Feedly provides an AI named Leo for aiding in filtering and discovering content in one's feed. While not completely granular, the system allows modifying inputs to improve finding content without some of the issues that may come with only having access to an algorithmic feed
  • Ampie is a discovery tool with bookmark functionality that one can connect to their Twitter account. When visiting a page, the browser extension will add a small tab to the bottom of the screen indicating how many others have either bookmarked ("amplified") on the service or shared the link on Twitter or Hacker News. The footer tab will also indicate the number of potentially interesting pages on the same domain. On pages that have been shared within your networks, links on pages visited with the extension enabled will be given a "footnote" marker with the & character. For more details see

Screenshot of Ampie introduction showing its footer bar tab with a pop up description of what the &, Twitter, and Hacker News icons indicate.

  • Lobsters is an open source, technology-focused link-aggregation service similar to Hacker News. Users can both post to it as well as discover interesting topic-specific content from others. Comments on the service will send Webmentions to the original link if syndicated from a personal website.
  • ...


Discovery UI

Questions to consider

Questions to consider to help understand the broad space of what do people mean by "discovery" from a user feature perspective:

  • How do I discover "interesting [to me]" content to read, listen to, watch?
  • How do I publish my content so folks interested in it can more easily discover it?
  • How can I help this content (or person) I found be more easily discoverable for others who may be interested in it (them) as well?

IndieWebCamp Related Sessions

See Also

Developer-centric definition

On the IndieWeb, you are your URL and your URL is you. With a well-designed IndieWeb site, as humans we can discover all the information you choose to share about yourself.

This page is for documenting and brainstorming ways to discover that same information automatically by following a combination of semantic markup and algorithms.

Profile Info

Typical IndieWeb sites have profile and often contact information right there on the home page.

Best publishing practice: mark it all up with hCard, especially your hyperlinks to other profiles with class="u-url url" and rel="me". This will create a representative hCard which can then be used by other sites. Use this tool to check how your hCard gets parsed.

Examples in the wild:

Best parsing practice: when given an indieweb URL that represents a person, parse it for a representative hCard and use that hCard for information about that person. Details:

Separate Contact Page

Some IndieWeb sites have contact information on a separate page from the home page, but linked from the home page. While such links may be obvious to humans, e.g. with text labels like "Contact" or "About", it's not at all obvious to parsers where to find more information.

Examples of sites with separate contact/about pages:


  • With a new 'rel' value, e.g. rel="contact-info", parsers could discover such links, follow them, and then parse the destination for a representative hCard.


Most IndieWeb sites have updates on their home page, a stream of updates as it were, for example:

Best publishing practice: mark up your posts with hAtom (and ideally microformats2 h-entry as well).

Best parsing practice: parse the given URL for hAtom (and preferably microformats2 h-entry).

Others have a simple introduction/contact page as their home page, and provide updates at another URL, for example:

  • ... old
  • ... any current examples? Maybe folks that have only an IndieWeb contact home page and then link to a separate page for their blog?


  • With a new 'rel' value, e.g. rel="updates", parsers could discover links to separate "journal", "updates", "notes", "stream" pages and then parse those for hAtom and h-entry.

Post Information

To discover information about a post on a post permalink page:

  • Parse the page for h-entry and retrieve post name, summary, URL, contents, and author accordingly.


Main article: authorship

Summary: (see main authorship page for full algorithm)

  • If the author is also an h-card, parse that for more information about the author such as name, photo, logo, URL, etc.
  • If there is no p-author, then look for a rel-author link.
    • Follow it, and retrieve the representative h-card from the destination for author information

Post Name

Assuming a post permalink page, see:

Publication Date

  • If the h-entry has a dt-published property, use that.
    • This is the only thing that's been implemented. Here are some fallbacks:
  • else the following sources may be used to infer it (brainstorming)
    • Check the URL path. If the start (? or somewhere near the start?) of the URL path of the permalink is:
    • /YYYY/MM/DD/ = publication date ISO YYYY-MM-DD
      • Sites using this:
    • /YYYY/DDD/ = publication date ISO Ordinal YYYY-DDD
      • Sites using this:
    • ...

POSSE copies

To find the POSSE copies of an original post, on that original post's permalink page:

  • Look for rel=syndication links
  • Treat their destinations as POSSE'd copies of the original post

Original post

To find an original post from a POSSE'd copy, on that POSSE'd copy's permalink page:

Real Time Updates

... rel=hub ... on link to PuSH hub for your updates.

Public Keys

For an improved Salmon key-discovery flow (that is, not using DRY-violating XRD files and web-breaking email-like identifiers), we need to expose public keys somehow.

Public key exchange was also discussed at the IndieWeb dinner on November 1st, 2013, in the context of this in-person using QR codes. Potentially the QR code could simply be a URL pointing to the user's website, where a public key could be extracted from microformat encoding.

Help or About

HTML has the rel="help" value, but it's not clear that it conveys the "about" kind of resources you link to.

IndieWeb Documentation

For example:

Legacy Discovery

There are bunch of legacy discovery methods that are worth documenting, in case you want to interoperate with legacy systems that depend on them.


... rel=alternate ... type=...+xml ...

We should deprecate separate feeds as:

  • Separate feeds are not technically necessary (hAtom or h-entry on visible HTML works just fine).
  • Separate feeds violate the DRY principle

Developer Examples

Examples that developers, e.g. folks at least familiar with manipulating and editing XML files, are publishing or can use:

See Also