Skip to content

Latest commit

 

History

History
104 lines (65 loc) · 3.14 KB

CONTRIBUTING.md

File metadata and controls

104 lines (65 loc) · 3.14 KB
Raw

Contributing

Abstract

The Devilbox is currently being developed in my spare time and mostly reflects the features that I am using for all the web projcets I have to handle. In order to better present it to the majority of other software developers I do require support to cope with all the feature requests.

So first of all, If the Devilbox makes your life easier, star it on GitHub!

Table of Contents

  1. How to contribute
    1. Documentation
    2. Docker Container
    3. New Features
    4. Intranet
    5. Tests
  2. Joining the Devilbox GitHub Organization
  3. Important

1. How to contribute

There are various areas that need support. If you are willing to help, pick a topic below and start contributing. If you are unclear about anything, let me know and I will clarify.

See the general ROADMAP for what is planned.

Documentation

Required knowledge: Sphinx

  • General improvement of the documentation (typos, grammar, etc)
  • Better documentation for setting up Xdebug
  • More how to's on how to setup a specific framework or CMS
  • General how to's and blog posts

Docker Container

Required knowledge: Docker, Ansible, Apache, Nginx, MySQL, PHP-FPM

  • Consolidate MySQL, PerconaDB and MariaDB into one repository for easier change management
  • Consolidate Nginx and Apache into one repository for easier change management
  • Performance improvements on Apache/Nginx and PHP-FPM
  • Add new container to the stack

New Features

Required knowledge: Various

Have a look at the GitHub issues and see if you can implement any features requested

Intranet

Required knowledge: PHP, HTML, CSS and Javascript

  • Fix email view: #337
  • Better and more modern layout
  • Try to remove as much vendor dependencies as possible

Tests

Required knowledge: Travis-CI

  • Shorten CI test time for faster releases
  • Rewrite current tests, write new tests

Joining the Devilbox GitHub Organization

If you want to contribute on a regular base and take care about major feature development you can be invited to the GitHub organization.

This however requires some prerequisites:

  1. Willing to dedicate a regular amount of time to invest in this project
  2. Already spent a decent amount of time in improving the Devilbox
  3. A good understanding about the Devilbox
  4. A good understanding about the PHP-FPM container (and how it is built with Ansible)

Important

This section will cover important information about various topics that need to be taken care of.

Updating Vendors

phpMyAdmin

The following settings must be applied to config.inc.php:

<?php
$cfg['TempDir'] = '/tmp';
$cfg['CheckConfigurationPermissions'] = false;

$cfg['blowfish_secret'] = 'add whatever value here';

$cfg['Servers'][$i]['host'] = 'mysql';
$cfg['Servers'][$i]['AllowNoPassword'] = true;