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

Subscribers

People subscribed via source and target branches

to status/vote changes: