Merge ~cjwatson/launchpad:doc-faq into launchpad:master

Proposed by Colin Watson
Status: Merged
Approved by: Colin Watson
Approved revision: f76c0fd17851774419d0d69ac234ed3450baf0db
Merge reported by: Otto Co-Pilot
Merged at revision: not available
Proposed branch: ~cjwatson/launchpad:doc-faq
Merge into: launchpad:master
Diff against target: 78 lines (+61/-0)
2 files modified
doc/faq.rst (+60/-0)
doc/index.rst (+1/-0)
Reviewer Review Type Date Requested Status
Jürgen Gmach Approve
Review via email: mp+412403@code.launchpad.net

Commit message

Add FAQ from dev.launchpad.net

Description of the change

To post a comment you must log in.
Revision history for this message
Jürgen Gmach (jugmac00) wrote :

I am not sure whether these are really frequently asked questions :-), but LGTM!

review: Approve

Preview Diff

[H/L] Next/Prev Comment, [J/K] Next/Prev File, [N/P] Next/Prev Hunk
1diff --git a/doc/faq.rst b/doc/faq.rst
2new file mode 100644
3index 0000000..5890dd2
4--- /dev/null
5+++ b/doc/faq.rst
6@@ -0,0 +1,60 @@
7+==========================
8+Frequently Asked Questions
9+==========================
10+
11+Are there Launchpad packages available?
12+=======================================
13+
14+No, Launchpad is not packaged and there are no plans to do so. Launchpad
15+deployment is done straight from Git branches and is quite complex.
16+
17+Why PostgreSQL?
18+===============
19+
20+PostgreSQL was chosen in 2004 because it supported most of the features we
21+thought we would need; MySQL did not. The other contender was Oracle, and
22+for a while we made sure we would be able to switch to Oracle if necessary
23+but PostgreSQL has worked great.
24+
25+How integrated is the database in the code?
26+===========================================
27+
28+Highly. We make use of PostgreSQL specific features, such as:
29+
30+* SQL language extensions
31+* PL/pgSQL and Python stored procedures
32+* Triggers
33+* Functional indexes
34+* Automatic load balancing over the replicas with Slony-I
35+* Transactional DDL
36+* tsearch2 full text search
37+* Database permissions
38+
39+What version of Python is required?
40+===================================
41+
42+Currently, Python 3.5.
43+
44+Can I look at the code without downloading it all?
45+==================================================
46+
47+Yes, you can browse the `source code
48+<https://git.launchpad.net/launchpad/tree>`_ on Launchpad. You can also use
49+``git clone https://git.launchpad.net/launchpad`` to download the code
50+without setting up a development environment.
51+
52+I have Launchpad running but mails are not sent...
53+==================================================
54+
55+Development Launchpads don't send email to the outside world, for obvious
56+reasons. They connect to the local SMTP server and send to root. To create
57+new users, create a new account, and check the local mailbox, or use
58+``utilities/make-lp-user``.
59+
60+My database permissions keep getting deleted!
61+=============================================
62+
63+If your local account is called "launchpad" it conflicts with a role called
64+"launchpad" which is defined in ``database/schema/security.cfg``. You need
65+to rename your local account and re-assign it superuser permissions as the
66+``utilities/launchpad-database-setup`` script does.
67diff --git a/doc/index.rst b/doc/index.rst
68index ff19541..6f42ae4 100644
69--- a/doc/index.rst
70+++ b/doc/index.rst
71@@ -20,6 +20,7 @@ Overview
72 strategy
73 scope
74 values
75+ faq
76
77 Guides
78 ======

Subscribers

People subscribed via source and target branches

to status/vote changes: