Configuration file for dwm-bar on macbook air
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

26 lines
1.5 KiB

  1. # Contributing to dwm-bar
  2. One goal of this project is to support as many (reasonable) plugins as possible which the user can enable or disable depending on their needs. This means that new plugins will almost always be a welcome addition.
  3. To ensure that dwm-bar stays compatible, uniform, and efficient there are a few guidelines that should be followed.
  4. The most important part of this project is to have fun using shell scripts. I created this prokect to learn, and learning only happens when mistakes are made, so don't worry too much.
  5. ## Making/editing a plugin
  6. * Ensure that plugins are POSIX compliant (use ```#!/bin/sh``` instead of ```#!/bin/bash``` etc.). A good way to check this is by using [ShellCheck](https://www.shellcheck.net/) on your script and amending compatibility errors.
  7. * Display plugin output in the terminal. This is easily done by wiriting the plugin in a function and calling the function at the end of the script. This helps with debugging and spotting errors.
  8. * Include a dependencies section at the top of the script (```Dependencies: example1, example2```).
  9. ## Editing dwm_bar.sh
  10. * Do not remove functions from the main script.
  11. ## Editing README.md
  12. * When adding a plugin to README.md, follow this template:
  13. ```
  14. ### plugin_name
  15. Description of the plugin
  16. ```
  17. [❗ Plugin output on bar]
  18. ```
  19. Dependencies: example1, example2
  20. ```
  21. * Ensure additons are added to the table of contents:
  22. ```
  23. - [Current Functions])(#current-functions)
  24. -[plugin_name](#plugin_name)
  25. ```