Re: [Mailman-Developers] Website re-org?

2015-12-26 Thread Barry Warsaw 
On Dec 24, 2015, at 09:55 AM, Tom Browder wrote:

>In my opinion, that link should replace ALL other links under the
>Documentation menu at the top of the home page (www.list.org), and it
>should clearly specify MM 3, something like:
>
>  Documentation
>
>Mailman 3 => http://docs.mailman3.org/en/latest/
>
>I am ready (finally) to start new lists with MM 3 and that, I assume,
>is where I should look.

Although, I do like the "quick links" nature of the Documentation menu.  One
less click once you know where you want to go.

Maybe the docs.mailman3.org page can be linked from an "Overview" menu item?

Cheers,
-Barry


pgpvQc6wGxUR9.pgp
Description: OpenPGP digital signature
___
Mailman-Developers mailing list
Mailman-Developers@python.org
https://mail.python.org/mailman/listinfo/mailman-developers
Mailman FAQ: http://wiki.list.org/x/AgA3
Searchable Archives: 
http://www.mail-archive.com/mailman-developers%40python.org/
Unsubscribe: 
https://mail.python.org/mailman/options/mailman-developers/archive%40jab.org

Security Policy: http://wiki.list.org/x/QIA9

Re: [Mailman-Developers] MM 3 REST API

2015-12-26 Thread Barry Warsaw 
On Dec 24, 2015, at 11:08 AM, Tom Browder wrote:

>Where should I look for the complete, definitive documentation on the
>MM3 REST API?

Sadly, there's no programmatic way to gather the specifications for the REST
API.  The best you have is the online documentation...

http://mailman.readthedocs.org/en/latest/README.html

...and the source.  You can refer to two other projects which access the API
though, and which might also help.

https://gitlab.com/mailman/mailmanclient - is the official Python bindings to
the REST API.

https://gitlab.com/astuart/mailmania - is Andrew Stuart's authenticating
proxy, which exposes a public REST API bridging to the internal REST API that
the core exposes.  At some point, we'll pull this in as an official
subproject.

I'd welcome contributions to help make the REST API more discoverable and/or
better documented.

Cheers,
-Barry
___
Mailman-Developers mailing list
Mailman-Developers@python.org
https://mail.python.org/mailman/listinfo/mailman-developers
Mailman FAQ: http://wiki.list.org/x/AgA3
Searchable Archives: 
http://www.mail-archive.com/mailman-developers%40python.org/
Unsubscribe: 
https://mail.python.org/mailman/options/mailman-developers/archive%40jab.org

Security Policy: http://wiki.list.org/x/QIA9

Re: [Mailman-Developers] MM 3 REST API

2015-12-26 Thread Tom Browder 
On Sat, Dec 26, 2015 at 11:29 AM, Barry Warsaw  wrote:
> On Dec 24, 2015, at 11:08 AM, Tom Browder wrote:
>
>>Where should I look for the complete, definitive documentation on the
>>MM3 REST API?
...

Thanks, Barry.

-Tom
___
Mailman-Developers mailing list
Mailman-Developers@python.org
https://mail.python.org/mailman/listinfo/mailman-developers
Mailman FAQ: http://wiki.list.org/x/AgA3
Searchable Archives: 
http://www.mail-archive.com/mailman-developers%40python.org/
Unsubscribe: 
https://mail.python.org/mailman/options/mailman-developers/archive%40jab.org

Security Policy: http://wiki.list.org/x/QIA9

Re: [Mailman-Developers] MM 3 REST API

2015-12-26 Thread Tom Browder 
On Sat, Dec 26, 2015 at 3:35 PM, Andrew Stuart
 wrote:
> Hi Tom,
>
> This is a Swagger spedification for the MM3 REST API - it defines the entire 
> API.
...

Thanks, Andrew!

Best regards,

-Tom
___
Mailman-Developers mailing list
Mailman-Developers@python.org
https://mail.python.org/mailman/listinfo/mailman-developers
Mailman FAQ: http://wiki.list.org/x/AgA3
Searchable Archives: 
http://www.mail-archive.com/mailman-developers%40python.org/
Unsubscribe: 
https://mail.python.org/mailman/options/mailman-developers/archive%40jab.org

Security Policy: http://wiki.list.org/x/QIA9

Re: [Mailman-Developers] Website re-org?

2015-12-26 Thread Terri Oda 

On 2015-12-26 9:32 AM, Barry Warsaw wrote:


Although, I do like the "quick links" nature of the Documentation menu.  One
less click once you know where you want to go.

Maybe the docs.mailman3.org page can be linked from an "Overview" menu item?


I use those quick links enough that I'd like to keep them too. 
"overview" or "START HERE" at the top of the menu should solve the 
problem, though.


___
Mailman-Developers mailing list
Mailman-Developers@python.org
https://mail.python.org/mailman/listinfo/mailman-developers
Mailman FAQ: http://wiki.list.org/x/AgA3
Searchable Archives: 
http://www.mail-archive.com/mailman-developers%40python.org/
Unsubscribe: 
https://mail.python.org/mailman/options/mailman-developers/archive%40jab.org

Security Policy: http://wiki.list.org/x/QIA9