This document contains guidelines for contributing to vimb, as well as useful hints when doing so.
Getting a light, fast and keyboard-driven browser that is easy to use for those users familiar with vim.
- Provide powerful knobs allowing the user to tweak vimb to fit the own needs and usecases.
- Add only knobs/features that do not do what other knobs do. In this point vimb is in contrast to vim.
- If there are two colliding features we should pick the mightier one, or that which need less code or resources.
Find something to work on
If you are interested to contribute to vimb it's a good idea to check if someone else is already working on. I would be a shame when you work was for nothing.
If you have some ideas how to improve vimb by new features or to simplify it. Write an issue so that other contributors can comment/vote on it or help you with it.
If you want to discuss some feature or provide some suggestion that can't be done very well with the github issues. You should use the mailing list for this purpose. Else it's a good decision to use the features provided by github for that.
Patching and Coding style
- Comment with LICENSE and possibly short explanation of file/tool
- Function declarations
- Include variable names
- For short files these can be left out
- Group/order in logical manner
- Global variables
- Function definitions in same order as declarations
- Do not mix declarations and code
- Do not use for loop initial declarations
/* */for comments, not
- Place system/libc headers first in alphabetical order
- If headers must be included in a specific order comment to explain
- Place local headers after an empty line
- Global variables not used outside translation unit should be declared static
- In declaration of pointers the
*is adjacent to variable name, not type
- the code is indented by 4 spaces - if you use vim to code you can set
:set expandtab ts=4 sts=4 sw=4
- it's a good advice to orientate on the already available code
- if you are using
indent, following options describe best the code style
compile and run
To inform vimb during compile time where the webextension should be loaded
RUNPREFIX option can be set to a full qualified path to the
directory where the extension should be stored in.
To run vimb without installation you could run as a sandbox like this
This will compile and install vimb into the local sandbox folder in the project directory.