1 |
caf16a48
|
Assos Assos
|
<!-- @file Overview on how to contribute to the Drupal Bootstrap project. -->
|
2 |
|
|
<!-- @defgroup -->
|
3 |
|
|
# Contributing
|
4 |
|
|
|
5 |
eefc2ac0
|
Assos Assos
|
Please read the @link faq FAQ @endlink and
|
6 |
|
|
@link getting_started Getting Started @endlink topics first before creating an
|
7 |
|
|
issue in this project's issue queue.
|
8 |
caf16a48
|
Assos Assos
|
|
9 |
|
|
Anything that falls within the scope of existing documentation or answered
|
10 |
eefc2ac0
|
Assos Assos
|
questions will be marked as "Closed (works as designed)" or
|
11 |
|
|
"Closed (won't fix)".
|
12 |
caf16a48
|
Assos Assos
|
|
13 |
9525582e
|
Assos Assos
|
The [Theme development](https://www.drupal.org/forum/3) support forum and
|
14 |
|
|
[Drupal StackExchange](https://drupal.stackexchange.com) are also amazing
|
15 |
caf16a48
|
Assos Assos
|
resources for asking questions, learning new techniques and overall general
|
16 |
|
|
support.
|
17 |
|
|
|
18 |
|
|
## Drupal.org Handbook Pages
|
19 |
eefc2ac0
|
Assos Assos
|
There has been some amazing Drupal Community work done around integration
|
20 |
|
|
between Drupal and the [Bootstrap Framework]. Additional community driven
|
21 |
|
|
documentation can be found on the [original Drupal.org handbook pages](https://www.drupal.org/node/1976938).
|
22 |
caf16a48
|
Assos Assos
|
|
23 |
|
|
If you find that the documentation in these locations are inaccurate or missing,
|
24 |
|
|
please update it yourself (all logged in users have edit capability).
|
25 |
|
|
|
26 |
|
|
## Creating New Issues
|
27 |
|
|
|
28 |
|
|
{.alert.alert-info} **Recommended reading:** [How To Solve All Your [Drupal] Problems](http://www.lullabot.com/blog/article/how-solve-all-your-problems)
|
29 |
|
|
|
30 |
9525582e
|
Assos Assos
|
{.alert.alert-warning} Please, [search the issue queue](https://www.drupal.org/project/issues/search/bootstrap)
|
31 |
caf16a48
|
Assos Assos
|
first. **DO NOT** duplicate existing issues.
|
32 |
|
|
|
33 |
|
|
**If you find an existing issue and the issue status is:**
|
34 |
|
|
- Closed (fixed, duplicate, won't fix) - **DO NOT** re-open it. Open a new
|
35 |
|
|
issue (unless it's "Closed (won't fix)") and reference the existing issue in
|
36 |
|
|
the "Related Issues" field.
|
37 |
|
|
- Active, NR, NW, RTBC - Please update the issue accordingly, **DO NOT** create
|
38 |
|
|
a new issue.
|
39 |
|
|
|
40 |
|
|
**The [Drupal Bootstrap] issue queue IS for:**
|
41 |
|
|
- Fixing bugs and adding new features pertaining to the integration between
|
42 |
|
|
Drupal and the [Bootstrap Framework].
|
43 |
|
|
|
44 |
|
|
**The [Drupal Bootstrap] issue queue IS NOT for:**
|
45 |
|
|
- Bugs/feature requests pertaining to the [Bootstrap Framework] itself. Use
|
46 |
|
|
[their issue queue](https://github.com/twbs/bootstrap/issues) instead.
|
47 |
|
|
- Custom CSS/Layout (e.g. site specific)
|
48 |
|
|
- LESS/SASS - Compilation errors, syntax, mixins/functions
|
49 |
|
|
- JavaScript, jQuery, Bootstrap plugins or custom (site specific) plugins
|
50 |
|
|
- Modules that don't work in multiple themes. File the issue with that module.
|
51 |
|
|
It is likely they are not using [APIs](https://api.drupal.org) properly, not
|
52 |
9525582e
|
Assos Assos
|
following existing [Coding Standards](https://www.drupal.org/coding-standards)
|
53 |
|
|
or not developing with [Best Practices](https://www.drupal.org/best-practices) in
|
54 |
caf16a48
|
Assos Assos
|
mind. It is actually a rare event when it is a legitimate issue with the
|
55 |
|
|
[Drupal Bootstrap] project.
|
56 |
|
|
|
57 |
|
|
## IRC
|
58 |
|
|
The [Drupal Bootstrap] project and its maintainers use the `#drupal-bootstrap`
|
59 |
|
|
channel on the freenode.net IRC network to communicate in real time. Please read
|
60 |
|
|
the following for more information on how to the community uses this technology:
|
61 |
|
|
[Chat with the Drupal Community on IRC](https://www.drupal.org/irc).
|
62 |
|
|
|
63 |
|
|
Please keep in mind though, this **IS NOT** a "support" channel. It's primary
|
64 |
|
|
use is to discuss issues and to help fix bugs with the base theme itself.
|
65 |
|
|
|
66 |
|
|
[Drupal Bootstrap]: https://www.drupal.org/project/bootstrap
|
67 |
9525582e
|
Assos Assos
|
[Bootstrap Framework]: https://getbootstrap.com/docs/3.3/ |