Skip to content

api-evangelist/developer

Repository files navigation

developer.apievangelist.com — Developer Portal

developer.apievangelist.com is the developer portal for the API Evangelist network. It aggregates every collection Kin Lane publishes across the network and documents each one as a consumable JSON feed.

Live site: https://developer.apievangelist.com

What's in this repo

  • _config.yml — Jekyll site configuration
  • _data/feeds.yml — the canonical catalog of every feed surfaced by this portal
  • _data/apisjson.yml — the APIs.json source for /apis.json
  • _layouts/, _includes/, assets/ — page templates and styling (matches the APIs.io developer portal look-and-feel)
  • feeds/ — one Markdown page per feed, each rendered via the feed layout
  • _posts/, blog/ — portal blog
  • index.md, about.md, network.md — landing, about, and network overview pages
  • apis.json, atom.xml — machine-readable indexes

The API Evangelist network

The feeds documented here are pulled from these collections:

Site What it publishes Repo
apis.apievangelist.com Individual APIs with OpenAPI reviews apis
posts.apievangelist.com 4,000+ blog posts since 2010 posts
conversations.apievangelist.com Producer/consumer/provider conversations conversations
contracts.apievangelist.com Business & technical contract details contracts
experiences.apievangelist.com Developer-experience records experiences
guidance.apievangelist.com Modular best-practice guidance guidance
partners.apievangelist.com Partner network partners
policies.apievangelist.com Governance policies policies
properties.apievangelist.com Governable API properties properties
rules.apievangelist.com Spectral rules rules
schema.apievangelist.com Schema definitions schema
standards.apievangelist.com Internet & industry standards standards
strategies.apievangelist.com API operations strategies strategies
utilities.apievangelist.com Utility APIs utilities
video.apievangelist.com Video content videos
vocabularies.apievangelist.com Controlled vocabularies vocabularies
spotlight-rules.com Curated rules spotlight spotlight-rules

Adding a new feed

  1. Add a new entry to _data/feeds.yml with slug, name, description, url, feed_url, repo_url, tags, and fields.
  2. Add a matching entry under apis: in _data/apisjson.yml.
  3. Create feeds/<slug>.md with the feed layout pointing at the new slug.
  4. Commit and push — GitHub Pages rebuilds on push.

Local development

bundle install
bundle exec jekyll serve

Related

About

The developer portal.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages