Hi,

On Mon, 05 Oct 2015, Daniel Pocock wrote:
> I can do some more work on this later today, will that be OK?

Sure.

> - I'm not sure it is optimal to include server setup stuff in the
> Workstation chapter, maybe it should just direct people to the services
> chapter (11)?

Yes, fine.

> - I ran ejabber for a long time but Prosody is also very popular.  The
> official debian.org SIP service (we tested it at DebConf15, it should be
> live very soon) is based on Prosody.  There are several DDs actively
> involved in the Prosody and module packaging.  Would you be happy if I
> put Prosody as the recommended option and ejabberd as an alternative?

Yes, but then you replace ejabberd setup instructions with prosody setup
instructions.

> - at the beginning, I would add an extra paragraph before 11.1, briefly
> mentioning that this chapter includes various RTC options and the RTC
> Quickstart is worth reading alongside chapter 11
> 
> - add 11.8 TURN server, cutting and pasting some content from
>      http://rtcquickstart.org/guide/multi/turn.html
> 
> - add 11.9 SIP server, cutting and pasting some content from
>      http://rtcquickstart.org/guide/multi/sip-proxy-repro.html
> 
> - add 11.10 Prosody XMPP server, cutting and pasting some content from
>      http://rtcquickstart.org/guide/multi/xmpp-server-prosody.html
>     and with a <sidebar> for ejabberd
> 
> - add 11.11 PBX server
>      briefly mention that Debian has Asterisk packages,
>      a full setup is too much to cover though

I think I prefer single 11.8 like in your initial patch, except that you
integrate a 11.8.1 to document the setup of prosody and do some
advertising of your RTC quickstart in 11.8.2 for those who want more
explanations about the other relevant services.

> - and file a wishlist bug for somebody to contribute:
>       11.12 IRC server setup

Not needed. Keeping the current sidebar as an alternative to the XMPP
setup is fine, although you might want to add an explanation of why
IRC does less than XMPP.

> - remove section 13.7.2
> 
> - create a new section "13.10 Real-time Communications"
>     with subsections
>      13.10.1 Instant Messaging and Chat
>      13.10.2 Voice and Video/webcam
>   This new section 13.10 would include:
>     - some of the content from section 13.7.2
>     - links to the service setup in chapter 11

Ok.

> Does this sound like a reasonable structure?

After taking into account my above comments, yes.

Cheers,
-- 
Raphaël Hertzog ◈ Debian Developer

Support Debian LTS: http://www.freexian.com/services/debian-lts.html
Learn to master Debian: http://debian-handbook.info/get/

Reply via email to