File: HACKME

package info (click to toggle)
gnome-clocks 3.30.1-2
  • links: PTS, VCS
  • area: main
  • in suites: buster
  • size: 2,732 kB
  • sloc: python: 68; ansic: 47; xml: 26; makefile: 4
file content (70 lines) | stat: -rw-r--r-- 1,923 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
HACKME
======

This file is intended to help new developers to get started with developing for
Clocks. Feel free to skip sections if you know what they are about.

Another good source for general information is:

 https://wiki.gnome.org/Apps/Clocks

1. How to Provide a Good Patch
==============================

 * Make sure you have just what belongs there in the changeset.
 * Read https://wiki.gnome.org/Git/CommitMessages carefully.
 * The preferred way of appending patches to bugs is via git bz.
   * As an alternative you can use "git format-patch HEAD~1".
 * The bugtracker has some quite cool features; use them!
 * Click on review to write comments to other or your patches or to comment
   comments on these patches.
 * Dont be afraid about criticism! The review process is probably going to be
   long.
 * We dont dislike you! We really appreciate your work.

2. Getting Started With Vala
============================

Check out:

 https://wiki.gnome.org/Projects/Vala/Documentation

Vala basics in 5 minutes:

 https://www.youtube.com/watch?v=k9hE0mumsCM

Good reference for the libraries used here:

 http://www.valadoc.org/

Information about UI-templates:

 http://blogs.gnome.org/tvb/2013/05/29/composite-templates-lands-in-vala/

3. Getting Started With Clocks
==============================

The best way to get started is to fix small bugs. If you don't find them, ask
on IRC.

4. Getting Started With coala
=============================

coala is a helping tool for developers to check for inconsistencies in the code.

You can install coala from:

 https://github.com/coala-analyzer/coala

To use coala, just open terminal and browse to code directory; then type:

 $ coala

coala will test for the following things:

 * No trailing spaces.
 * No tabs.
 * Line lengths less than 120.

If any of the above tests fail for any line(s) coala will prompt you to fix it
alongwith the location of that line.