Skip to content

Commit 63f702e

Browse files
authored
Merge pull request #18 from codacy/add-version-to-readme
Add version to readme
2 parents 0519c01 + 648e689 commit 63f702e

File tree

2 files changed

+75
-12
lines changed

2 files changed

+75
-12
lines changed

CONTRIBUTING.md

Lines changed: 59 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,59 @@
1+
# How to contribute
2+
3+
## Main rules
4+
5+
* Before you open a ticket or send a pull request, [search](https://github.com/codacy/codacy-plugins-api/issues) for previous discussions about the same feature or issue. Add any new details to earlier tickets if you find any.
6+
7+
* If you're proposing a new feature, make sure you create an issue to let other contributors know what you will be working on.
8+
9+
* Before sending a pull request make sure your code is tested.
10+
11+
* Before sending a pull request for a feature, be sure to run tests with `./scripts/test.sh`.
12+
13+
* Use the same coding style as the rest of the codebase, most of the checks can be performed with `./scripts/lint.sh`.
14+
15+
* Use `git rebase` (not `git merge`) to sync your work from time to time with the master branch.
16+
17+
* After creating your pull request make sure the build is passing on [CircleCI](https://circleci.com/gh/codacy/codacy-plugins-api) and that [Codacy](https://www.codacy.com/app/Codacy/codacy-plugins-api) is also confident in the code quality.
18+
19+
## Commit Style
20+
21+
Writing good commit logs is important. A commit log should describe what changed and why.
22+
Follow these guidelines when writing one:
23+
24+
1. The first line should be 50 characters or less and contain a short
25+
description of the change prefixed with the name of the changed
26+
subsystem (e.g. "net: add localAddress and localPort to Socket").
27+
2. Keep the second line blank.
28+
3. Wrap all other lines at 72 columns.
29+
30+
A good commit log can look something like this:
31+
32+
```git-commit
33+
subsystem: explaining the commit in one line
34+
35+
Body of commit message is a few lines of text, explaining things
36+
in more detail, possibly giving some background about the issue
37+
being fixed, etc. etc.
38+
39+
The body of the commit message can be several paragraphs, and
40+
please do proper word-wrap and keep columns shorter than about
41+
72 characters or so. That way `git log` will show things
42+
nicely even when it is indented.
43+
```
44+
45+
### Developer's Certificate of Origin 1.0
46+
47+
By making a contribution to this project, I certify that:
48+
49+
* (a) The contribution was created in whole or in part by me and I
50+
have the right to submit it under the open source license indicated
51+
in the file; or
52+
* (b) The contribution is based upon previous work that, to the best
53+
of my knowledge, is covered under an appropriate open source license
54+
and I have the right under that license to submit that work with
55+
modifications, whether created in whole or in part by me, under the
56+
same open source license (unless I am permitted to submit under a
57+
different license), as indicated in the file; or
58+
* (c) The contribution was provided directly to me by some other
59+
person who certified (a), (b) or (c) and I have not modified it.

README.md

Lines changed: 16 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -3,27 +3,31 @@
33
[![Codacy Badge](https://api.codacy.com/project/badge/Grade/23d335c474ce4317ad35b19cb90a1f35)](https://www.codacy.com/app/Codacy/codacy-plugins-api?utm_source=github.com&utm_medium=referral&utm_content=codacy/codacy-plugins-api&utm_campaign=Badge_Grade)
44
[![Codacy Badge](https://api.codacy.com/project/badge/Coverage/23d335c474ce4317ad35b19cb90a1f35)](https://www.codacy.com/app/Codacy/codacy-plugins-api?utm_source=github.com&utm_medium=referral&utm_content=codacy/codacy-plugins-api&utm_campaign=Badge_Coverage)
55
[![CircleCI](https://circleci.com/gh/codacy/codacy-plugins-api.svg?style=svg)](https://circleci.com/gh/codacy/codacy-plugins-api)
6+
[![Maven Central](https://maven-badges.herokuapp.com/maven-central/com.codacy/codacy-plugins-api_2.12/badge.svg)](https://maven-badges.herokuapp.com/maven-central/com.codacy/codacy-plugins-api_2.12)
67

78
A dependency free api for codacy-engines
89

9-
This repository is ment to be the interface between
10-
.) codacy engines (currently via https://github.com/codacy/codacy-engine-scala-seed),
11-
.) the plugins-test and
12-
.) codacy's internal component running engines and picking up their results
10+
This repository is meant to be the interface between
1311

14-
it's held dependency free so we are flexible on changing (versions of) mainly json-libraries on the components that use it.
12+
* Codacy analysis tools (currently via [codacy-engine-scala-seed](https://github.com/codacy/codacy-engine-scala-seed))
13+
* Codacy duplication tools (currently via [codacy-duplication-scala-seed](https://github.com/codacy/codacy-duplication-scala-seed))
14+
* Codacy metrics tools (currently via [codacy-metrics-scala-seed](https://github.com/codacy/codacy-metrics-scala-seed))
15+
* The tests with [codacy-plugins-test](https://github.com/codacy/codacy-plugins-test)
16+
* Codacy's internal component running tools and picking up their results
1517

16-
## What is Codacy?
18+
It's held dependency free so we are flexible on changing (versions of) mainly json-libraries on the components that use it.
19+
20+
## What is Codacy
1721

1822
[Codacy](https://www.codacy.com/) is an Automated Code Review Tool that monitors your technical debt, helps you improve your code quality, teaches best practices to your developers, and helps you save time in Code Reviews.
1923

20-
### Among Codacy’s features:
24+
### Among Codacy’s features
2125

22-
- Identify new Static Analysis issues
23-
- Commit and Pull Request Analysis with GitHub, BitBucket/Stash, GitLab (and also direct git repositories)
24-
- Auto-comments on Commits and Pull Requests
25-
- Integrations with Slack, HipChat, Jira, YouTrack
26-
- Track issues in Code Style, Security, Error Proneness, Performance, Unused Code and other categories
26+
* Identify new Static Analysis issues
27+
* Commit and Pull Request Analysis with GitHub, BitBucket/Stash, GitLab (and also direct git repositories)
28+
* Auto-comments on Commits and Pull Requests
29+
* Integrations with Slack, HipChat, Jira, YouTrack
30+
* Track issues in Code Style, Security, Error Proneness, Performance, Unused Code and other categories
2731

2832
Codacy also helps keep track of Code Coverage, Code Duplication, and Code Complexity.
2933

0 commit comments

Comments
 (0)