Skip to content

Commit 886cda7

Browse files
committed
[FEATURE] 📝 Add feedback loop to Readme
1 parent 2c5716f commit 886cda7

File tree

2 files changed

+64
-15
lines changed

2 files changed

+64
-15
lines changed

CONTRIBUTING.md

Lines changed: 49 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Contributing
22

3-
Thank you for your proposed contribution! This guide will help you along.
3+
🔰 Thank you for your proposed contribution! This guide will help you along.
44

55
## Code of Conduct
66

@@ -14,24 +14,65 @@ The general idea of this project is described in the [README](./README.md#Vision
1414

1515
## How to contribute
1616

17-
There are many ways to [contribute to Open Source projects](https://opensource.guide/de/how-to-contribute/)
18-
beyond coding.
17+
There are many ways to [contribute to Open Source projects](https://opensource.guide/how-to-contribute/)
18+
beyond coding. Draft a new design, test features and give feedback, report bugs,
19+
improve the documentation, review the issue tracker and suggest closing
20+
duplicates or outdated tickets. Spread the word and write a tweet or blog post.
21+
22+
You like to code? Find an open issue and fix a bug. Add tests or improve the
23+
project setup. Or build a new feature.
24+
25+
## Workspace
26+
27+
🚧 This project is maintained on GitLab.
28+
29+
It is mirrored to GitHub though. If you feel more comfortable with GitHub,
30+
then you are able to work with this mirror just fine.
31+
All issues and pull requests are mirrored to GitLab.
1932

2033
## Opening a ticket
2134

35+
Please always open a ticket or comment on existing issues before you start
36+
working on something.
37+
2238
- [Guide to open a ticket](https://opensource.guide/how-to-contribute/#opening-an-issue)
2339

24-
## Opening a Pull Request
40+
## Opening a pull request
41+
42+
- [Guide to open a pull request](https://opensource.guide/how-to-contribute/#opening-a-pull-request)
43+
- [Guide to update a pull request](https://github.com/RichardLitt/knowledge/blob/master/github/amending-a-commit-guide.md)
44+
45+
Keep your pull requests limited to a single issue. One feature branch per issue.
2546

26-
- [Guide to open a Pull Request](https://opensource.guide/how-to-contribute/#opening-a-pull-request)
27-
- [Guide to update a Pull Request](https://github.com/RichardLitt/knowledge/blob/master/github/amending-a-commit-guide.md)
47+
Please explain your changes in a short,
48+
[readable commit message](https://pixelbrackets.de/notes/commit-message-format).
2849

2950
## Coding Guidelines
3051

31-
This project has adopted the [PSR-2 Coding Style Guide](https://www.php-fig.org/psr/psr-2/).
52+
This project has adopted the
53+
[PSR-2 Coding Style Guide](https://www.php-fig.org/psr/psr-2/) for PHP Code.
54+
55+
General file formats are defined in the [EditorConfig](https://editorconfig.org/).
56+
57+
The project follows the naming scheme of the
58+
[Flow Framework](https://flowframework.readthedocs.io/en/stable/TheDefinitiveGuide/PartV/CodingGuideLines/PHP.html#naming)
59+
for classes, methods, variables and filenames.
60+
61+
✅ Don't worry. The guidlines are checked automatically in every pull request.
3262

3363
## Release cycle
3464

3565
This project has adopted [SemVer 2 Versioning](https://semver.org/).
3666

37-
New commits are composed in `development` until a new version is released.
67+
New commits are composed in branch `development` until a new version is
68+
released.
69+
70+
All notable changes made between each release are documented in the
71+
[Changelog](./CHANGELOG.md).
72+
73+
## Feedback
74+
75+
[Everything in open source should be a series of kindnesses](https://snarky.ca/setting-expectations-for-open-source-participation/#everythinginopensourceshouldbeaseriesofkindnesses).
76+
77+
Please send some [feedback](https://pixelbrackets.de/) and share how this
78+
package has proven useful to you and how you may help to improve it.

README.md

Lines changed: 15 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -6,11 +6,13 @@
66
[![License](https://img.shields.io/badge/license-gpl--2.0--or--later-blue.svg?style=flat-square)](https://spdx.org/licenses/GPL-2.0-or-later.html)
77
[![Contribution](https://img.shields.io/badge/contributions_welcome-%F0%9F%94%B0-brightgreen.svg?labelColor=brightgreen&style=flat-square)](https://gitlab.com/pixelbrackets/html5-mini-template/-/blob/master/CONTRIBUTING.md)
88

9-
The packages provides an HTML5 mini template for quick rendering of
10-
status pages, TOC pages, or any other minimal single-serving site.
9+
HTML5 Mini Template for quick rendering of status pages, TOC pages,
10+
or any other minimal single-serving site.
1111

1212
![Screenshot](./docs/screenshot.png)
1313

14+
_⭐ You like this package? Please star it or send a tweet. ⭐_
15+
1416
## Vision
1517

1618
This package provides a single class to turn a message or HTML-snippet into
@@ -42,7 +44,7 @@ to pass a custom title.
4244

4345
## Requirements
4446

45-
* PHP
47+
- PHP
4648

4749
## Installation
4850

@@ -52,7 +54,8 @@ Packagist Entry https://packagist.org/packages/pixelbrackets/html5-mini-template
5254

5355
https://gitlab.com/pixelbrackets/html5-mini-template/
5456

55-
Mirror https://github.com/pixelbrackets/html5-mini-template
57+
Mirror https://github.com/pixelbrackets/html5-mini-template/ (Issues & Pull Requests
58+
mirrored to GitLab)
5659

5760
## Demo
5861

@@ -131,10 +134,15 @@ Dan Untenzu (<[email protected]> / [@pixelbrackets](https://pixelbrackets.de
131134

132135
## Changelog
133136

134-
See [./CHANGELOG.md](CHANGELOG.md)
137+
See [CHANGELOG.md](./CHANGELOG.md)
135138

136139
## Contribution
137140

138-
This script is Open Source, so please use, patch, extend or fork it.
141+
This script is Open Source, so please use, share, patch, extend or fork it.
142+
143+
[Contributions](./CONTRIBUTING.md) are welcome!
144+
145+
## Feedback
139146

140-
[Contributions](CONTRIBUTING.md) are welcome!
147+
Please send some [feedback](https://pixelbrackets.de/) and share how this
148+
package has proven useful to you or how you may help to improve it.

0 commit comments

Comments
 (0)