From 2d6d1086986e6405714d34fdd811b0727ec2e98a Mon Sep 17 00:00:00 2001
From: Eric Poirier <eric.poirier@eclipse-foundation.org>
Date: Wed, 23 Jan 2019 13:45:23 -0500
Subject: [PATCH] Update Mailing List documentation
Change-Id: I0811ea91c4a20995c04c8bae1977af5aae73ce54
Signed-off-by: Eric Poirier <eric.poirier@eclipse-foundation.org>
---
docs/auth.html | 4 +-
docs/index.html | 99 +++++++++++++++++++++++++++++-----
docs/proposals.html | 4 +-
src/modules/mailing_lists.apib | 47 ++++++++++++++--
4 files changed, 132 insertions(+), 22 deletions(-)
diff --git a/docs/auth.html b/docs/auth.html
index 066b416..b525303 100644
--- a/docs/auth.html
+++ b/docs/auth.html
@@ -205,8 +205,8 @@ are used.</p>
]
</span>}</code></pre><div style="height: 1px;"></div></div></div></div></div></section></div></div></div><p style="text-align: center;" class="text-muted">
Copyright ©
-2018
-The Eclipse Foundation. All Rights Reserved.</p><p style="text-align: center;" class="text-muted hide">Generated by <a href="https://github.com/danielgtaylor/aglio" class="aglio">aglio</a> on 12 Jun 2018</p><script>/* eslint-env browser */
+2019
+The Eclipse Foundation. All Rights Reserved.</p><p style="text-align: center;" class="text-muted hide">Generated by <a href="https://github.com/danielgtaylor/aglio" class="aglio">aglio</a> on 23 Jan 2019</p><script>/* eslint-env browser */
/* eslint quotes: [2, "single"] */
'use strict';
diff --git a/docs/index.html b/docs/index.html
index cca9504..067a5de 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -116,7 +116,7 @@ height="0" width="0" style="display:none;visibility:hidden"></iframe></noscript>
</div>
</div>
</div>
-</header><a href="#top" class="text-muted back-to-top"><i class="fa fa-toggle-up"></i> Back to top</a><div class="container-fluid container-content"><div class="row"><nav><div class="resource-group"><div class="heading"><div class="chevron"><i class="open fa fa-angle-down"></i></div><a href="#top">Overview</a></div><div class="collapse-content"><ul><li><a href="#header-other-related-rest-apis">Other related REST APIs</a></li><li><a href="#header-rate-limit">Rate Limit</a></li><li><a href="#header-pagination">Pagination</a></li><li><a href="#header-caching">Caching</a></li><li><a href="#header-authentication">Authentication</a></li><li><a href="#header-error-states">Error States</a></li></ul></div></div><div class="resource-group"><div class="heading"><div class="chevron"><i class="open fa fa-angle-down"></i></div><a href="#user-profiles">User Profiles</a></div><div class="collapse-content"><ul><li><a href="#user-profiles-current-user-get"><span class="badge get"><i class="fa fa-arrow-down"></i></span>Current user</a></li><li><a href="#user-profiles-retrieve-user-get"><span class="badge get"><i class="fa fa-arrow-down"></i></span>Retrieve user</a></li><li><a href="#user-profiles-search-for-a-user-get"><span class="badge get"><i class="fa fa-arrow-down"></i></span>Search for a user</a></li><li><a href="#user-profiles-forum-posts-get"><span class="badge get"><i class="fa fa-arrow-down"></i></span>Forum posts</a></li><li><a href="#user-profiles-project-relationship-get"><span class="badge get"><i class="fa fa-arrow-down"></i></span>Project Relationship</a></li><li><a href="#user-profiles-gerrit-review-count-get"><span class="badge get"><i class="fa fa-arrow-down"></i></span>Gerrit review count</a></li><li><a href="#user-profiles-mailing-list-subscriptions-get"><span class="badge get"><i class="fa fa-arrow-down"></i></span>Mailing List Subscriptions</a></li></ul></div></div><div class="resource-group"><div class="heading"><div class="chevron"><i class="open fa fa-angle-down"></i></div><a href="#eclipse-uss">Eclipse USS</a></div><div class="collapse-content"><ul><li><a href="#eclipse-uss-fetch-blobs-get"><span class="badge get"><i class="fa fa-arrow-down"></i></span>Fetch Blobs</a></li><li><a href="#eclipse-uss-search-blobs-get"><span class="badge get"><i class="fa fa-arrow-down"></i></span>Search Blobs</a></li><li><a href="#eclipse-uss-delete-blobs-delete"><span class="badge delete"><i class="fa fa-times"></i></span>Delete Blobs</a></li><li><a href="#eclipse-uss-update-create-blobs-put"><span class="badge put"><i class="fa fa-pencil"></i></span>Update/Create Blobs</a></li></ul></div></div><div class="resource-group"><div class="heading"><div class="chevron"><i class="open fa fa-angle-down"></i></div><a href="#download">Download</a></div><div class="collapse-content"><ul><li><a href="#download-retrieve-file-get"><span class="badge get"><i class="fa fa-arrow-down"></i></span>Retrieve File</a></li><li><a href="#download-release-get"><span class="badge get"><i class="fa fa-arrow-down"></i></span>Release</a></li></ul></div></div><div class="resource-group"><div class="heading"><div class="chevron"><i class="open fa fa-angle-down"></i></div><a href="#marketplace-favorites">Marketplace Favorites</a></div><div class="collapse-content"><ul><li><a href="#marketplace-favorites-search-favorites-get"><span class="badge get"><i class="fa fa-arrow-down"></i></span>Search Favorites</a></li><li><a href="#marketplace-favorites-retrieve-favorites-get"><span class="badge get"><i class="fa fa-arrow-down"></i></span>Retrieve Favorites</a></li><li><a href="#marketplace-favorites-random-favorites-get"><span class="badge get"><i class="fa fa-arrow-down"></i></span>Random Favorites</a></li><li><a href="#marketplace-favorites-favorite-list">Favorite List</a><ul><li><a href="#marketplace-favorites-favorite-list-post"><span class="badge post"><i class="fa fa-plus"></i></span>Add Favorite</a></li><li><a href="#marketplace-favorites-favorite-list-delete"><span class="badge delete"><i class="fa fa-times"></i></span>Remove Favorite</a></li><li><a href="#marketplace-favorites-favorite-list-post-1"><span class="badge post"><i class="fa fa-plus"></i></span>Rename Favorite List</a></li></ul></li></ul></div></div><div class="resource-group"><div class="heading"><div class="chevron"><i class="open fa fa-angle-down"></i></div><a href="#forums">Forums</a></div><div class="collapse-content"><ul><li><a href="#forums-fetch-categories-get"><span class="badge get"><i class="fa fa-arrow-down"></i></span>Fetch Categories</a></li><li><a href="#forums-retrieve-category-get"><span class="badge get"><i class="fa fa-arrow-down"></i></span>Retrieve Category</a></li><li><a href="#forums-fetch-forums-get"><span class="badge get"><i class="fa fa-arrow-down"></i></span>Fetch Forums</a></li><li><a href="#forums-retrieve-forum-get"><span class="badge get"><i class="fa fa-arrow-down"></i></span>Retrieve Forum</a></li><li><a href="#forums-fetch-topics-get"><span class="badge get"><i class="fa fa-arrow-down"></i></span>Fetch Topics</a></li><li><a href="#forums-retrieve-topic-get"><span class="badge get"><i class="fa fa-arrow-down"></i></span>Retrieve Topic</a></li><li><a href="#forums-fetch-posts-get"><span class="badge get"><i class="fa fa-arrow-down"></i></span>Fetch Posts</a></li><li><a href="#forums-retrieve-post-get"><span class="badge get"><i class="fa fa-arrow-down"></i></span>Retrieve Post</a></li><li><a href="#forums-retrieve-user-get"><span class="badge get"><i class="fa fa-arrow-down"></i></span>Retrieve User</a></li></ul></div></div><div class="resource-group"><div class="heading"><div class="chevron"><i class="open fa fa-angle-down"></i></div><a href="#mailing-lists">Mailing Lists</a></div><div class="collapse-content"><ul><li><a href="#mailing-lists-fetch-mailing-lists-metadata-get"><span class="badge get"><i class="fa fa-arrow-down"></i></span>Fetch Mailing lists Metadata</a></li></ul></div></div><p style="text-align: center; word-wrap: break-word;"><a href="https://api.eclipse.org">https://api.eclipse.org</a></p></nav><div class="content"><header><h1 id="top">Eclipse RESTful API</h1></header><p>This describes the resources that make up the official Eclipse Foundation REST API.</p>
+</header><a href="#top" class="text-muted back-to-top"><i class="fa fa-toggle-up"></i> Back to top</a><div class="container-fluid container-content"><div class="row"><nav><div class="resource-group"><div class="heading"><div class="chevron"><i class="open fa fa-angle-down"></i></div><a href="#top">Overview</a></div><div class="collapse-content"><ul><li><a href="#header-other-related-rest-apis">Other related REST APIs</a></li><li><a href="#header-rate-limit">Rate Limit</a></li><li><a href="#header-pagination">Pagination</a></li><li><a href="#header-caching">Caching</a></li><li><a href="#header-authentication">Authentication</a></li><li><a href="#header-error-states">Error States</a></li></ul></div></div><div class="resource-group"><div class="heading"><div class="chevron"><i class="open fa fa-angle-down"></i></div><a href="#user-profiles">User Profiles</a></div><div class="collapse-content"><ul><li><a href="#user-profiles-current-user-get"><span class="badge get"><i class="fa fa-arrow-down"></i></span>Current user</a></li><li><a href="#user-profiles-retrieve-user-get"><span class="badge get"><i class="fa fa-arrow-down"></i></span>Retrieve user</a></li><li><a href="#user-profiles-search-for-a-user-get"><span class="badge get"><i class="fa fa-arrow-down"></i></span>Search for a user</a></li><li><a href="#user-profiles-forum-posts-get"><span class="badge get"><i class="fa fa-arrow-down"></i></span>Forum posts</a></li><li><a href="#user-profiles-project-relationship-get"><span class="badge get"><i class="fa fa-arrow-down"></i></span>Project Relationship</a></li><li><a href="#user-profiles-gerrit-review-count-get"><span class="badge get"><i class="fa fa-arrow-down"></i></span>Gerrit review count</a></li><li><a href="#user-profiles-mailing-list-subscriptions-get"><span class="badge get"><i class="fa fa-arrow-down"></i></span>Mailing List Subscriptions</a></li></ul></div></div><div class="resource-group"><div class="heading"><div class="chevron"><i class="open fa fa-angle-down"></i></div><a href="#eclipse-uss">Eclipse USS</a></div><div class="collapse-content"><ul><li><a href="#eclipse-uss-fetch-blobs-get"><span class="badge get"><i class="fa fa-arrow-down"></i></span>Fetch Blobs</a></li><li><a href="#eclipse-uss-search-blobs-get"><span class="badge get"><i class="fa fa-arrow-down"></i></span>Search Blobs</a></li><li><a href="#eclipse-uss-delete-blobs-delete"><span class="badge delete"><i class="fa fa-times"></i></span>Delete Blobs</a></li><li><a href="#eclipse-uss-update-create-blobs-put"><span class="badge put"><i class="fa fa-pencil"></i></span>Update/Create Blobs</a></li></ul></div></div><div class="resource-group"><div class="heading"><div class="chevron"><i class="open fa fa-angle-down"></i></div><a href="#download">Download</a></div><div class="collapse-content"><ul><li><a href="#download-retrieve-file-get"><span class="badge get"><i class="fa fa-arrow-down"></i></span>Retrieve File</a></li><li><a href="#download-release-get"><span class="badge get"><i class="fa fa-arrow-down"></i></span>Release</a></li></ul></div></div><div class="resource-group"><div class="heading"><div class="chevron"><i class="open fa fa-angle-down"></i></div><a href="#marketplace-favorites">Marketplace Favorites</a></div><div class="collapse-content"><ul><li><a href="#marketplace-favorites-search-favorites-get"><span class="badge get"><i class="fa fa-arrow-down"></i></span>Search Favorites</a></li><li><a href="#marketplace-favorites-retrieve-favorites-get"><span class="badge get"><i class="fa fa-arrow-down"></i></span>Retrieve Favorites</a></li><li><a href="#marketplace-favorites-random-favorites-get"><span class="badge get"><i class="fa fa-arrow-down"></i></span>Random Favorites</a></li><li><a href="#marketplace-favorites-favorite-list">Favorite List</a><ul><li><a href="#marketplace-favorites-favorite-list-post"><span class="badge post"><i class="fa fa-plus"></i></span>Add Favorite</a></li><li><a href="#marketplace-favorites-favorite-list-delete"><span class="badge delete"><i class="fa fa-times"></i></span>Remove Favorite</a></li><li><a href="#marketplace-favorites-favorite-list-post-1"><span class="badge post"><i class="fa fa-plus"></i></span>Rename Favorite List</a></li></ul></li></ul></div></div><div class="resource-group"><div class="heading"><div class="chevron"><i class="open fa fa-angle-down"></i></div><a href="#forums">Forums</a></div><div class="collapse-content"><ul><li><a href="#forums-fetch-categories-get"><span class="badge get"><i class="fa fa-arrow-down"></i></span>Fetch Categories</a></li><li><a href="#forums-retrieve-category-get"><span class="badge get"><i class="fa fa-arrow-down"></i></span>Retrieve Category</a></li><li><a href="#forums-fetch-forums-get"><span class="badge get"><i class="fa fa-arrow-down"></i></span>Fetch Forums</a></li><li><a href="#forums-retrieve-forum-get"><span class="badge get"><i class="fa fa-arrow-down"></i></span>Retrieve Forum</a></li><li><a href="#forums-fetch-topics-get"><span class="badge get"><i class="fa fa-arrow-down"></i></span>Fetch Topics</a></li><li><a href="#forums-retrieve-topic-get"><span class="badge get"><i class="fa fa-arrow-down"></i></span>Retrieve Topic</a></li><li><a href="#forums-fetch-posts-get"><span class="badge get"><i class="fa fa-arrow-down"></i></span>Fetch Posts</a></li><li><a href="#forums-retrieve-post-get"><span class="badge get"><i class="fa fa-arrow-down"></i></span>Retrieve Post</a></li><li><a href="#forums-retrieve-user-get"><span class="badge get"><i class="fa fa-arrow-down"></i></span>Retrieve User</a></li></ul></div></div><div class="resource-group"><div class="heading"><div class="chevron"><i class="open fa fa-angle-down"></i></div><a href="#mailing-lists">Mailing Lists</a></div><div class="collapse-content"><ul><li><a href="#mailing-lists-fetch-mailing-lists-get"><span class="badge get"><i class="fa fa-arrow-down"></i></span>Fetch Mailing lists</a></li><li><a href="#mailing-lists-retrieve-mailing-list-get"><span class="badge get"><i class="fa fa-arrow-down"></i></span>Retrieve Mailing List</a></li></ul></div></div><p style="text-align: center; word-wrap: break-word;"><a href="https://api.eclipse.org">https://api.eclipse.org</a></p></nav><div class="content"><header><h1 id="top">Eclipse RESTful API</h1></header><p>This describes the resources that make up the official Eclipse Foundation REST API.</p>
<p>You can contribute to this document via our <a href="https://github.com/chrisguindon/api.eclipse.org-docs">git repository</a>.</p>
<p>If you have any problems or requests please contact <a href="mailto:chris.guindon@eclipse-foundation.org">Christopher Guindon</a>.</p>
<h3 id="header-other-related-rest-apis">Other related REST APIs <a class="permalink" href="#header-other-related-rest-apis" aria-hidden="true">¶</a></h3>
@@ -2722,7 +2722,7 @@ You can also retrieve posts that have been created between dates using the since
"<span class="hljs-attribute">account_url</span>": <span class="hljs-value"><span class="hljs-string">"https://api.eclipse.org/account/profile?mail=test@user.org"</span></span>,
"<span class="hljs-attribute">posts_url</span>": <span class="hljs-value"><span class="hljs-string">"https://api.eclipse.org/forums/post?user_id=1"</span>
</span>}</code></pre><div style="height: 1px;"></div></div></div></div></div></section><section id="mailing-lists" class="resource-group"><h2 class="group-heading">Mailing Lists <a href="#mailing-lists" class="permalink">¶</a></h2><p>Eclipse Mailing Lists are available through this resource.</p>
-<div id="mailing-lists-fetch-mailing-lists-metadata" class="resource"><h3 class="resource-heading">Fetch Mailing lists Metadata <a href="#mailing-lists-fetch-mailing-lists-metadata" class="permalink"> ¶</a></h3><div id="mailing-lists-fetch-mailing-lists-metadata-get" class="action get"><h4 class="action-heading"><div class="name">Fetch Mailing lists Metadata</div><a href="#mailing-lists-fetch-mailing-lists-metadata-get" class="method get">GET</a><code class="uri">/mailing_lists/metadata{?name,search,page,pagesize,order_by}</code></h4><h3 id="header-overview-9">Overview <a class="permalink" href="#header-overview-9" aria-hidden="true">¶</a></h3>
+<div id="mailing-lists-fetch-mailing-lists" class="resource"><h3 class="resource-heading">Fetch Mailing lists <a href="#mailing-lists-fetch-mailing-lists" class="permalink"> ¶</a></h3><div id="mailing-lists-fetch-mailing-lists-get" class="action get"><h4 class="action-heading"><div class="name">Fetch Mailing lists</div><a href="#mailing-lists-fetch-mailing-lists-get" class="method get">GET</a><code class="uri">/foundation/mailing-list{?search,page,pagesize,order_by}</code></h4><h3 id="header-overview-9">Overview <a class="permalink" href="#header-overview-9" aria-hidden="true">¶</a></h3>
<p>Retrieve metadata for all the mailing lists.</p>
<h3 id="header-result-definition-9">Result definition <a class="permalink" href="#header-result-definition-9" aria-hidden="true">¶</a></h3>
<ul>
@@ -2730,32 +2730,103 @@ You can also retrieve posts that have been created between dates using the since
<p><strong>list_name:</strong> name of the mailing list</p>
</li>
<li>
+<p><strong>list_description:</strong> description of the mailing list</p>
+</li>
+<li>
+<p><strong>project_id:</strong> Id of the project related to the mailing list</p>
+</li>
+<li>
+<p><strong>list_short_description:</strong> short description of the mailing list</p>
+</li>
+<li>
+<p><strong>is_disabled:</strong> if the mailing list is disabled</p>
+</li>
+<li>
+<p><strong>is_deleted:</strong> if the mailing list is deleted</p>
+</li>
+<li>
+<p><strong>is_subscribable:</strong> if the mailing list is subscribable</p>
+</li>
+<li>
+<p><strong>create_date:</strong> the date the mailing list was created</p>
+</li>
+<li>
<p><strong>url:</strong> url of the mailing list</p>
</li>
<li>
<p><strong>email:</strong> email of the mailing list</p>
</li>
</ul>
-<h4>Example URI</h4><div class="definition"><span class="method get">GET</span> <span class="uri"><span class="hostname">https://api.eclipse.org</span>/mailing_lists/metadata?<span class="hljs-attribute">name=</span><span class="hljs-literal"></span>&<span class="hljs-attribute">search=</span><span class="hljs-literal"></span>&<span class="hljs-attribute">page=</span><span class="hljs-literal"></span>&<span class="hljs-attribute">pagesize=</span><span class="hljs-literal"></span>&<span class="hljs-attribute">order_by=</span><span class="hljs-literal"></span></span></div><div class="title"><strong>URI Parameters</strong><div class="collapse-button show"><span class="close">Hide</span><span class="open">Show</span></div></div><div class="collapse-content"><dl class="inner"><dt>name</dt><dd><code>string</code> <span>(optional)</span> <p>The name of a specific mailing list</p>
-</dd><dt>search</dt><dd><code>string</code> <span>(optional)</span> <p>A keyword to search for in a mailing list name</p>
+<h4>Example URI</h4><div class="definition"><span class="method get">GET</span> <span class="uri"><span class="hostname">https://api.eclipse.org</span>/foundation/mailing-list?<span class="hljs-attribute">search=</span><span class="hljs-literal"></span>&<span class="hljs-attribute">page=</span><span class="hljs-literal"></span>&<span class="hljs-attribute">pagesize=</span><span class="hljs-literal"></span>&<span class="hljs-attribute">order_by=</span><span class="hljs-literal"></span></span></div><div class="title"><strong>URI Parameters</strong><div class="collapse-button show"><span class="close">Hide</span><span class="open">Show</span></div></div><div class="collapse-content"><dl class="inner"><dt>search</dt><dd><code>string</code> <span>(optional)</span> <p>A keyword to search for in a mailing list name</p>
</dd><dt>page</dt><dd><code>integer</code> <span>(optional)</span> <p>The index of the page to get, defaults to 1.</p>
</dd><dt>pagesize</dt><dd><code>integer</code> <span>(optional)</span> <p>The number of records to get per page, defaults to 20. Maximum value is 100.</p>
</dd><dt>order_by</dt><dd><code>string</code> <span>(optional)</span> <p>The order by name in which the results will be returned. ASC by default</p>
-</dd></dl></div><div class="title"><strong>Response <code>200</code></strong><div class="collapse-button"><span class="close">Hide</span><span class="open">Show</span></div></div><div class="collapse-content"><div class="inner"><h5>Headers</h5><pre><code><span class="hljs-attribute">Content-Type</span>: <span class="hljs-string">application/json</span><br><span class="hljs-attribute">Link</span>: <span class="hljs-string"><https://api.eclipse.org/mailing_lists/metadata?page=1&amp;pagesize=20>; rel="next", <https://api.eclipse.org/mailing_lists/metadata?page=99&amp;pagesize=5>; rel="last", <https://api.eclipse.org/mailing_lists/metadata?page=1&amp;pagesize=5>; rel="first", <https://api.eclipse.org/mailing_lists/metadata?page=1&amp;pagesize=5>; rel="self"</span><br><span class="hljs-attribute">X-Rate-Limit-Limit</span>: <span class="hljs-string">1000</span><br><span class="hljs-attribute">X-Rate-Limit-Remaining</span>: <span class="hljs-string">964</span><br><span class="hljs-attribute">X-Rate-Limit-Reset</span>: <span class="hljs-string">3553</span><br><span class="hljs-attribute">Content-Type</span>: <span class="hljs-string">application/json</span></code></pre><div style="height: 1px;"></div><h5>Body</h5><pre><code>[
+</dd></dl></div><div class="title"><strong>Response <code>200</code></strong><div class="collapse-button"><span class="close">Hide</span><span class="open">Show</span></div></div><div class="collapse-content"><div class="inner"><h5>Headers</h5><pre><code><span class="hljs-attribute">Content-Type</span>: <span class="hljs-string">application/json</span><br><span class="hljs-attribute">Link</span>: <span class="hljs-string"><https://api.eclipse.org/foundation/mailing-list?page=1&amp;pagesize=20>; rel="next", <https://api.eclipse.org/foundation/mailing-list?page=99&amp;pagesize=5>; rel="last", <https://api.eclipse.org/foundation/mailing-list?page=1&amp;pagesize=5>; rel="first", <https://api.eclipse.org/foundation/mailing-list?page=1&amp;pagesize=5>; rel="self"</span><br><span class="hljs-attribute">X-Rate-Limit-Limit</span>: <span class="hljs-string">1000</span><br><span class="hljs-attribute">X-Rate-Limit-Remaining</span>: <span class="hljs-string">964</span><br><span class="hljs-attribute">X-Rate-Limit-Reset</span>: <span class="hljs-string">3553</span><br><span class="hljs-attribute">Content-Type</span>: <span class="hljs-string">application/json</span></code></pre><div style="height: 1px;"></div><h5>Body</h5><pre><code>[
{
- "<span class="hljs-attribute">list_name</span>": <span class="hljs-value"><span class="hljs-string">"example-list1"</span></span>,
- "<span class="hljs-attribute">url</span>": <span class="hljs-value"><span class="hljs-string">"https://accounts.eclipse.org/mailing-list/example-list1"</span></span>,
- "<span class="hljs-attribute">email</span>": <span class="hljs-value"><span class="hljs-string">"example-list1@eclipse.org"</span>
- </span>},
+ "<span class="hljs-attribute">list_name</span>": <span class="hljs-value"><span class="hljs-string">"dash-dev"</span></span>,
+ "<span class="hljs-attribute">list_description</span>": <span class="hljs-value"><span class="hljs-string">"Tools for Committer Community"</span></span>,
+ "<span class="hljs-attribute">project_id</span>": <span class="hljs-value"><span class="hljs-string">""</span></span>,
+ "<span class="hljs-attribute">list_short_description</span>": <span class="hljs-value"><span class="hljs-literal">null</span></span>,
+ "<span class="hljs-attribute">is_disabled</span>": <span class="hljs-value"><span class="hljs-string">"0"</span></span>,
+ "<span class="hljs-attribute">is_deleted</span>": <span class="hljs-value"><span class="hljs-string">"0"</span></span>,
+ "<span class="hljs-attribute">is_subscribable</span>": <span class="hljs-value"><span class="hljs-string">"1"</span></span>,
+ "<span class="hljs-attribute">create_date</span>": <span class="hljs-value"><span class="hljs-literal">null</span></span>,
+ "<span class="hljs-attribute">url</span>": <span class="hljs-value"><span class="hljs-string">"https://accounts.eclipse.org/mailing-list/dash-dev"</span></span>,
+ "<span class="hljs-attribute">email</span>": <span class="hljs-value"><span class="hljs-string">"dash-dev@eclipse.org"</span>
+ </span>}
+]</code></pre><div style="height: 1px;"></div></div></div></div></div><div id="mailing-lists-retrieve-mailing-list" class="resource"><h3 class="resource-heading">Retrieve Mailing List <a href="#mailing-lists-retrieve-mailing-list" class="permalink"> ¶</a></h3><div id="mailing-lists-retrieve-mailing-list-get" class="action get"><h4 class="action-heading"><div class="name">Retrieve Mailing List</div><a href="#mailing-lists-retrieve-mailing-list-get" class="method get">GET</a><code class="uri">/foundation/mailing-list/</code></h4><h3 id="header-overview-10">Overview <a class="permalink" href="#header-overview-10" aria-hidden="true">¶</a></h3>
+<p>Retrieve information for a specific mailing list</p>
+<h3 id="header-result-definition-10">Result definition <a class="permalink" href="#header-result-definition-10" aria-hidden="true">¶</a></h3>
+<ul>
+<li>
+<p><strong>list_name:</strong> name of the mailing list</p>
+</li>
+<li>
+<p><strong>list_description:</strong> description of the mailing list</p>
+</li>
+<li>
+<p><strong>project_id:</strong> Id of the project related to the mailing list</p>
+</li>
+<li>
+<p><strong>list_short_description:</strong> short description of the mailing list</p>
+</li>
+<li>
+<p><strong>is_disabled:</strong> if the mailing list is disabled</p>
+</li>
+<li>
+<p><strong>is_deleted:</strong> if the mailing list is deleted</p>
+</li>
+<li>
+<p><strong>is_subscribable:</strong> if the mailing list is subscribable</p>
+</li>
+<li>
+<p><strong>create_date:</strong> the date the mailing list was created</p>
+</li>
+<li>
+<p><strong>url:</strong> url of the mailing list</p>
+</li>
+<li>
+<p><strong>email:</strong> email of the mailing list</p>
+</li>
+</ul>
+<h4>Example URI</h4><div class="definition"><span class="method get">GET</span> <span class="uri"><span class="hostname">https://api.eclipse.org</span>/foundation/mailing-list/</span></div><div class="title"><strong>URI Parameters</strong><div class="collapse-button show"><span class="close">Hide</span><span class="open">Show</span></div></div><div class="collapse-content"><dl class="inner"><dt>name</dt><dd><code>integer</code> <span class="required">(required)</span> <p>Name of the mailing list</p>
+</dd></dl></div><div class="title"><strong>Response <code>200</code></strong><div class="collapse-button"><span class="close">Hide</span><span class="open">Show</span></div></div><div class="collapse-content"><div class="inner"><h5>Headers</h5><pre><code><span class="hljs-attribute">Content-Type</span>: <span class="hljs-string">application/json</span><br><span class="hljs-attribute">X-Rate-Limit-Limit</span>: <span class="hljs-string">1000</span><br><span class="hljs-attribute">X-Rate-Limit-Remaining</span>: <span class="hljs-string">964</span><br><span class="hljs-attribute">X-Rate-Limit-Reset</span>: <span class="hljs-string">3553</span><br><span class="hljs-attribute">Content-Type</span>: <span class="hljs-string">application/json</span></code></pre><div style="height: 1px;"></div><h5>Body</h5><pre><code>[
{
- "<span class="hljs-attribute">list_name</span>": <span class="hljs-value"><span class="hljs-string">"example-list2"</span></span>,
- "<span class="hljs-attribute">url</span>": <span class="hljs-value"><span class="hljs-string">"https://accounts.eclipse.org/mailing-list/example-list2"</span></span>,
- "<span class="hljs-attribute">email</span>": <span class="hljs-value"><span class="hljs-string">"example-list2@eclipse.org"</span>
+ "<span class="hljs-attribute">list_name</span>": <span class="hljs-value"><span class="hljs-string">"dash-dev"</span></span>,
+ "<span class="hljs-attribute">list_description</span>": <span class="hljs-value"><span class="hljs-string">"Tools for Committer Community"</span></span>,
+ "<span class="hljs-attribute">project_id</span>": <span class="hljs-value"><span class="hljs-string">""</span></span>,
+ "<span class="hljs-attribute">list_short_description</span>": <span class="hljs-value"><span class="hljs-literal">null</span></span>,
+ "<span class="hljs-attribute">is_disabled</span>": <span class="hljs-value"><span class="hljs-string">"0"</span></span>,
+ "<span class="hljs-attribute">is_deleted</span>": <span class="hljs-value"><span class="hljs-string">"0"</span></span>,
+ "<span class="hljs-attribute">is_subscribable</span>": <span class="hljs-value"><span class="hljs-string">"1"</span></span>,
+ "<span class="hljs-attribute">create_date</span>": <span class="hljs-value"><span class="hljs-literal">null</span></span>,
+ "<span class="hljs-attribute">url</span>": <span class="hljs-value"><span class="hljs-string">"https://accounts.eclipse.org/mailing-list/dash-dev"</span></span>,
+ "<span class="hljs-attribute">email</span>": <span class="hljs-value"><span class="hljs-string">"dash-dev@eclipse.org"</span>
</span>}
]</code></pre><div style="height: 1px;"></div></div></div></div></div></section></div></div></div><p style="text-align: center;" class="text-muted">
Copyright ©
-2018
-The Eclipse Foundation. All Rights Reserved.</p><p style="text-align: center;" class="text-muted hide">Generated by <a href="https://github.com/danielgtaylor/aglio" class="aglio">aglio</a> on 12 Jun 2018</p><script>/* eslint-env browser */
+2019
+The Eclipse Foundation. All Rights Reserved.</p><p style="text-align: center;" class="text-muted hide">Generated by <a href="https://github.com/danielgtaylor/aglio" class="aglio">aglio</a> on 23 Jan 2019</p><script>/* eslint-env browser */
/* eslint quotes: [2, "single"] */
'use strict';
diff --git a/docs/proposals.html b/docs/proposals.html
index dc17546..96c7928 100644
--- a/docs/proposals.html
+++ b/docs/proposals.html
@@ -120,8 +120,8 @@ height="0" width="0" style="display:none;visibility:hidden"></iframe></noscript>
<p>Please note that these are not on production and ready to use.</p>
</div></div></div><p style="text-align: center;" class="text-muted">
Copyright ©
-2018
-The Eclipse Foundation. All Rights Reserved.</p><p style="text-align: center;" class="text-muted hide">Generated by <a href="https://github.com/danielgtaylor/aglio" class="aglio">aglio</a> on 15 May 2018</p><script>/* eslint-env browser */
+2019
+The Eclipse Foundation. All Rights Reserved.</p><p style="text-align: center;" class="text-muted hide">Generated by <a href="https://github.com/danielgtaylor/aglio" class="aglio">aglio</a> on 23 Jan 2019</p><script>/* eslint-env browser */
/* eslint quotes: [2, "single"] */
'use strict';
diff --git a/src/modules/mailing_lists.apib b/src/modules/mailing_lists.apib
index 9e72395..73d390d 100644
--- a/src/modules/mailing_lists.apib
+++ b/src/modules/mailing_lists.apib
@@ -2,7 +2,7 @@
Eclipse Mailing Lists are available through this resource.
-## Fetch Mailing lists Metadata [GET /mailing_lists/metadata{?name,search,page,pagesize,order_by}]
+## Fetch Mailing lists [GET /foundation/mailing-list{?search,page,pagesize,order_by}]
### Overview
@@ -11,11 +11,17 @@ Retrieve metadata for all the mailing lists.
### Result definition
+ **list_name:** name of the mailing list
++ **list_description:** description of the mailing list
++ **project_id:** Id of the project related to the mailing list
++ **list_short_description:** short description of the mailing list
++ **is_disabled:** if the mailing list is disabled
++ **is_deleted:** if the mailing list is deleted
++ **is_subscribable:** if the mailing list is subscribable
++ **create_date:** the date the mailing list was created
+ **url:** url of the mailing list
+ **email:** email of the mailing list
+ Parameters
- + name (string, optional) - The name of a specific mailing list
+ search (string, optional) - A keyword to search for in a mailing list name
+ page (integer, optional) - The index of the page to get, defaults to 1.
+ pagesize (integer, optional) - The number of records to get per page, defaults to 20. Maximum value is 100.
@@ -23,13 +29,46 @@ Retrieve metadata for all the mailing lists.
+ Response 200 (application/json)
+ Headers
- Link:<https://api.eclipse.org/mailing_lists/metadata?page=1&pagesize=20>; rel="next", <https://api.eclipse.org/mailing_lists/metadata?page=99&pagesize=5>; rel="last", <https://api.eclipse.org/mailing_lists/metadata?page=1&pagesize=5>; rel="first", <https://api.eclipse.org/mailing_lists/metadata?page=1&pagesize=5>; rel="self"
+ Link:<https://api.eclipse.org/foundation/mailing-list?page=1&pagesize=20>; rel="next", <https://api.eclipse.org/foundation/mailing-list?page=99&pagesize=5>; rel="last", <https://api.eclipse.org/foundation/mailing-list?page=1&pagesize=5>; rel="first", <https://api.eclipse.org/foundation/mailing-list?page=1&pagesize=5>; rel="self"
X-Rate-Limit-Limit: 1000
X-Rate-Limit-Remaining: 964
X-Rate-Limit-Reset: 3553
Content-Type: application/json
+ Body
- [{"list_name":"example-list1","url":"https://accounts.eclipse.org/mailing-list/example-list1","email":"example-list1@eclipse.org"},{"list_name":"example-list2","url":"https://accounts.eclipse.org/mailing-list/example-list2","email":"example-list2@eclipse.org"}]
+ [{"list_name":"dash-dev","list_description":"Tools for Committer Community","project_id":"","list_short_description":null,"is_disabled":"0","is_deleted":"0","is_subscribable":"1","create_date":null,"url":"https://accounts.eclipse.org/mailing-list/dash-dev","email":"dash-dev@eclipse.org"}]
+
+
+## Retrieve Mailing List [GET /foundation/mailing-list/{mailing_list_id}]
+
+### Overview
+
+Retrieve information for a specific mailing list
+
+### Result definition
+
++ **list_name:** name of the mailing list
++ **list_description:** description of the mailing list
++ **project_id:** Id of the project related to the mailing list
++ **list_short_description:** short description of the mailing list
++ **is_disabled:** if the mailing list is disabled
++ **is_deleted:** if the mailing list is deleted
++ **is_subscribable:** if the mailing list is subscribable
++ **create_date:** the date the mailing list was created
++ **url:** url of the mailing list
++ **email:** email of the mailing list
+
++ Parameters
+ + name (integer) - Name of the mailing list
+
++ Response 200 (application/json)
+ + Headers
+ X-Rate-Limit-Limit: 1000
+ X-Rate-Limit-Remaining: 964
+ X-Rate-Limit-Reset: 3553
+ Content-Type: application/json
+
+ + Body
+ [{"list_name":"dash-dev","list_description":"Tools for Committer Community","project_id":"","list_short_description":null,"is_disabled":"0","is_deleted":"0","is_subscribable":"1","create_date":null,"url":"https://accounts.eclipse.org/mailing-list/dash-dev","email":"dash-dev@eclipse.org"}]
--
GitLab