~launchpad-pqm/launchpad/devel

« back to all changes in this revision

Viewing changes to database/schema/comments.sql

  • Committer: Stuart Bishop
  • Date: 2011-11-17 13:09:51 UTC
  • mfrom: (9795.4.39 replication)
  • mto: This revision was merged to the branch mainline in revision 14433.
  • Revision ID: stuart.bishop@canonical.com-20111117130951-hi6w5tswg9q3gbit
Merged replication into db-deploy.

Show diffs side-by-side

added added

removed removed

Lines of Context:
6
6
     GNU Affero General Public License version 3 (see the file LICENSE).
7
7
*/
8
8
 
 
9
-- AccessPolicy
 
10
 
 
11
COMMENT ON TABLE AccessPolicy IS 'An access policy used to manage a project or distribution\'s artifacts.';
 
12
COMMENT ON COLUMN AccessPolicy.product IS 'The product that this policy is used on.';
 
13
COMMENT ON COLUMN AccessPolicy.distribution IS 'The distribution that this policy is used on.';
 
14
COMMENT ON COLUMN AccessPolicy.type IS 'The type of policy (an enum value). Private, Security, etc.';
 
15
 
 
16
-- AccessPolicyArtifact
 
17
 
 
18
COMMENT ON TABLE AccessPolicyArtifact IS 'An artifact that an access grant can apply to. Additional private artifacts should be handled by adding new columns here, rather than new tables or columns on AccessPolicyGrant.';
 
19
COMMENT ON COLUMN AccessPolicyArtifact.bug IS 'The bug that this abstract artifact represents.';
 
20
COMMENT ON COLUMN AccessPolicyArtifact.branch IS 'The branch that this abstract artifact represents.';
 
21
COMMENT ON COLUMN AccessPolicyArtifact.policy IS 'An optional policy that controls access to this artifact. Otherwise the artifact is public.';
 
22
 
 
23
-- AccessPolicyGrant
 
24
 
 
25
COMMENT ON TABLE AccessPolicyGrant IS 'A grant for a person to access a specific artifact or all artifacts controlled by a particular policy.';
 
26
COMMENT ON COLUMN AccessPolicyGrant.grantee IS 'The person to whom access is granted.';
 
27
COMMENT ON COLUMN AccessPolicyGrant.grantor IS 'The person who granted the access.';
 
28
COMMENT ON COLUMN AccessPolicyGrant.date_created IS 'The date the access was granted.';
 
29
COMMENT ON COLUMN AccessPolicyGrant.policy IS 'The policy on which access is granted.';
 
30
COMMENT ON COLUMN AccessPolicyGrant.artifact IS 'The artifact on which access is granted.';
 
31
 
9
32
-- Announcement
10
33
 
11
34
COMMENT ON TABLE Announcement IS 'A project announcement. This is a single item of news or information that the project is communicating. Announcements can be attached to a Project, a Product or a Distribution.';
1200
1223
COMMENT ON COLUMN LaunchpadDatabaseRevision.minor IS 'Minor number. Patches made during development each increment the minor number.';
1201
1224
COMMENT ON COLUMN LaunchpadDatabaseRevision.patch IS 'The patch number will hopefully always be ''0'', as it exists to support emergency patches made to the production server. eg. If production is running ''4.0.0'' and needs to have a patch applied ASAP, we would create a ''4.0.1'' patch and roll it out. We then may need to refactor all the existing ''4.x.0'' patches.';
1202
1225
 
 
1226
-- LaunchpadDatabaseUpdateLog
 
1227
COMMENT ON TABLE LaunchpadDatabaseUpdateLog IS 'Record of Launchpad database schema updates. When and what update.py was run.';
 
1228
 
1203
1229
-- Karma
1204
1230
COMMENT ON TABLE Karma IS 'Used to quantify all the ''operations'' a user performs inside the system, which maybe reporting and fixing bugs, uploading packages, end-user support, wiki editting, etc.';
1205
1231
COMMENT ON COLUMN Karma.action IS 'A foreign key to the KarmaAction table.';
2390
2416
COMMENT ON TABLE DatabaseCpuStats IS 'Snapshots of CPU utilization per database username.';
2391
2417
COMMENT ON COLUMN DatabaseCpuStats.cpu IS '% CPU utilization * 100, as reported by ps -o cp';
2392
2418
 
2393
 
 
2394
2419
-- SuggestivePOTemplate
2395
2420
COMMENT ON TABLE SuggestivePOTemplate IS
2396
2421
'Cache of POTemplates that can provide external translation suggestions.';
2397
2422
 
2398
 
 
2399
2423
-- OpenIdIdentifier
2400
2424
COMMENT ON TABLE OpenIdIdentifier IS
2401
2425
'OpenId Identifiers that can be used to log into an Account.';
2402
2426
COMMENT ON COLUMN OpenIdIdentifier.identifier IS
2403
2427
'OpenId Identifier. This should be a URL, but is currently just a token that can be used to generate the Identity URL for the Canonical SSO OpenId Provider.';
2404