Re: [diaspora-installer] new strings review request
Pirate Praveen wrote:
> I have added it to description, please see if it fits in there.
[...]
> Package: diaspora-installer
[...]
> Description: distributed social networking service - installer
[...]
> .
> This package configures PostgreSQL as the database and Nginx as the web server.
> It downloads diaspora and install dependencies using rubygems packaging system.
That second line is a bit broken, and probably they ought to be in the
opposite order -
This package downloads diaspora and its installation dependencies
using the rubygems packaging system. It configures PostgreSQL as
the database and Nginx as the web server.
Or maybe just
This package uses the rubygems packaging system to download Diaspora
and its dependencies, then configures it with PostgreSQL and Nginx.
> Package: diaspora-common
[...]
> Description: distributed social networking service - common files
[...]
> .
> This package configures PostgreSQL as the database and Nginx as the web server.
> It provides files common for the diaspora and diaspora-installer packages.
There's not much point repeating the part about PostgreSQL and Nginx
here (though if you end up with alternative plugin packages like
diaspora-mariadb it would make sense delegating it to them). Just
keep it to:
This package provides files common for the diaspora and
diaspora-installer packages.
[ - suture -]
> I have also added warning about self-signed certificates. They are
> useful only for local testing and cannot be used to communicate with
> other diaspora pods.
Okay.
> .
> Running Diaspora requires at least a self-signed SSL certificate, which
> can be generated using (for instance) the package easy-rsa.
>+ .
>+ But a self-signed certificate can only be used for local testing, other
>+ diaspora pods will not accept a self-signed certificate and this breaks
>+ federation (your pod will not be able to communicate with other pods).
>+ .
>+ startssl.com is the only certification authority that provide free SSL
>+ certificates that works with diaspora (CAcert provided certificates will
>+ not work).
This should probably be two paragraphs, one about self-signed
certificates and the other about... whatever you call the opposite.
Third-party-signed certificates?
Running Diaspora requires at least a self-signed SSL certificate.
Such a certificate (which can be generated using, for instance, the
package easy-rsa) is enough for local testing, but will not be
accepted for federation with other Diaspora pods.
.
Communicating with other pods requires a third-party-signed SSL
certificate; however, certificates provided by CAcert will not work
with Diaspora. The only certification authority providing free SSL
certificates that will work with Diaspora is startssl.com.
--
JBR with qualifications in linguistics, experience as a Debian
sysadmin, and probably no clue about this particular package
Reply to: