Justin B Rye എഴുതി: > Pirate Praveen wrote:>> Template: diaspora-common/intro >> Type: text >> _Description: Getting started with diaspora-installer> The Developers >> Reference (§6.5.3.1.7) says of "Type: text" that "This > type is now considered obsolete: don't use it." The information > should probably be somewhere else - the package description? A > README.Debian? If it absolutely has to be delivered via debconf, it > could be "Type: note", but that's usually worth avoiding if possible > (because for a start it's hard to refer back to it later).
I will move some of it to description and look at notes. >> This package lets you setup a diaspora pod in easy steps. It configures >> postgresql as database and nginx as web server.> The verb is two words: >> "set up". Diaspora, PostgreSQL, and Nginx > should probably be capitalised (the "brand name" of the software in > general, not a particular Debian package/executable). > > This package lets you set up a Diaspora pod in easy steps. It configures > PostgreSQL as the database and Nginx as the web server. > > But if this paragraph is news to anybody installing the package you > probably need a better package description. I will add it to description. It is just informing them the choice of PostgreSQL over MySQL and Nginx over Apache. >> . >> You can leave PostgreSQL application password blank as we use "ident" >> authentication method (diaspora user on the system can connect to >> diaspora database without password).> There are some missing articles here; >> how about: > > You can leave the PostgreSQL application password blank, as the "ident" > authentication method is used, allowing the diaspora user on the system > to connect to the Diaspora database without a password. > > (Or maybe diaspora should be Diaspora, or vice versa - I forget, are > the user and database *named* "diaspora"?) database name is diaspora_production. It could be changed to diaspora if that is better. > Why tell a user this now rather than as part of the step where it asks > them for a password? that is coming from dbconfig-common. That is a generic message asking for password which may be left blank. I want to avoid confusion to user and explicitly tell them to leave it blank. If there is a way to skip dbconfig-common questions and go with defaults, that would be great too. >> . >> You will need an ssl certificate for running diaspora. You can generate >> a self signed certificate using easy-rsa package.> Again, capitalisation >> and articles: > > Running Diaspora requires at least a self-signed SSL certificate, which > can be generated using (for instance) the package easy-rsa. > > (This seems to imply that there should be a Recommends: or at least > Suggests: from diaspora to easy-rsa, in which case this explanation > for the dependency might belong in the package description.) I'll move it to description and add Suggests. That leaves only the note about leaving password field empty. > >> Template: diaspora-common/url >> Type: string >> Default: localhost >> _Description: Host name for this instance of Diaspora: >> Please choose the host name which should be used to access this >> instance of Diaspora. >> . >> This should be the fully qualified name as seen from the Internet, with >> the domain name that will be used to access the pod. >> . >> If a reverse proxy is used, give the hostname that the proxy server >> responds to. >> . >> This host name should not be modified after the initial setup because >> it is hard-coded in the database.> This one I've seen before.> -- > JBR with qualifications in linguistics, experience as a Debian > sysadmin, and probably no clue about this particular package -- To UNSUBSCRIBE, email to [email protected] with a subject of "unsubscribe". Trouble? Contact [email protected] Archive: https://lists.debian.org/1430619532204.52d7a31130cb88@mozgaia
