/
format.html
executable file
·36 lines (27 loc) · 1.91 KB
/
format.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
---
layout: page
title: The API Report Format
---
<h1 class="title">The API Report Format</h1>
<p><a href="http://api.report/2014/08/03/bitly-updates-their-privacy-policy/"><img src="https://s3.amazonaws.com/kinlane-productions/api-report/api-report-format-example.png" align="right" width="250" style="padding: 15px;" /></a></p>
<p>The API Report is meant to provide an easy to read format, allowing anyone to quickly scan the daily API news, and if they want more detail they can visit linked websites for more information.</p>
<p>After four years of publishing API analysis on <a href="http://apievangelist.com">API Evangelist</a>, you start to get a feel for the format readers prefer, something I've adapted to be the API Report format:
<ul class="mainlist">
<li>Informative, catchy title</li>
<li>Simple opening paragraph</li>
<li>Meet of the news in bullets or paragraph format</li>
<li>Quick wrapup paragraph</li>
<li>Single photo</li>
<li>Link to more information</li>
</ul>
<p>The goal is to provide a summary of the news, without adding much analysis or opinion, allowing readers to quicklky get up to speed and decide if they want to click, and receive more information.</p>
<p>While the editorial process is fairly open, we will be looking for posts that stick to this simple format, avoiding longer pieces that are over 500 words. We will provide feedback with any posts that are rejected, giving authors a change to better understand the format.</p>
<p>If you have any feedback, submit as issue, or fork the website and make the changes, and submit a pull request.</p>
<br /><br />
<!-- 3scale -->
<p align="center">
<a href="http://3scale.net" target="_blank" title="APIs From 3Scale">
<img src="https://s3.amazonaws.com/kinlane-productions/api-service-providers/3Scale/empowered-by-3scale.png" width="300" style="padding-bottom: 15px;" />
</a>
</p>
<!-- 3scale -->