aboutsummaryrefslogtreecommitdiff
path: root/CONTRIBUTING.md
blob: 7641c13e35133cf9ef67b91e294e7ad65961109b (plain)
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
## Reporting

### Reporting bugs
Please include the following when reporting bugs:
* Operating system used
* Version of Qt used
* Detailed explanation of the bug: 
  * what was done
  * what was expected
  * what happened

## Contributing

### Hooks
Symlink the hooks:
```
ln -s ../../util/pre-commit.sh .git/hooks/pre-commit
```

### Versioning

#### Major version
Changed infrequently and almost entirely out of foppery and whim.

#### Minor version
Milestone of multiple features.

#### Revision
Major bugfixes and each new feature should get a revision.

### Branching
* master - main branch, should be kept up-to-date, and have only working code
* development - development branch, anything goes there

### Folder structure

  folder       | description
  ------       | -----------
/src           | source code
/src/widgets   | subclassed Qt widgets
/src/forms     | Qt UI forms and classes
/src/webengine | QWebEngine* subclasses
/test          | test run location, mainly for QtCreator

### QtCreator
* In the project Run Settings set the working directory to _$repo/test_, and the
command line arguments to _-c ./config.ini_.

### firejail
Any submitted modifications must work with the provided firejail profile.