On this page:
This website is our public-facing web presence — most folks' first stop for ViewVC information. But those folks who are looking to make use of our development tools and such will need to become familiar with our Tigris.org project site:
It's at that site where our source code, mailing lists, issue tracker, etc. are all hosted.
In fact, you can explore ViewVC's source code and version control history using a ViewVC instance hosted at that site:
As far as development skills goes, some basic knowledge
about Python and development
Testing and Reporting
Testing usability and the installation process on different platforms is also a valuable contribution. Please report your results back to us developers. Bandwidth is getting cheaper daily, so don't be afraid — in fact, feel encouraged — to dump as much detail about the problems you are seeing as possible into your bug reports. Here are some things you definitely should try to include:
Unlike its predecessor, CvsWeb, ViewVC is written in Python, so it doesn't suffer from the "unmaintainable code effect" that hits most Perl projects sooner or later:
Of course, a symphony of insanity can be composed in any language,
so we do try to stick to some basic guiding principles. Maintain
whatever style is present in the code being modified. New code can
use anything sane (which generally means PEP 8).
Our only real peeve is if someone writes a function call as:
Nothing speaks more loudly when bugs or features are the topic than a patch. And quite frankly, sometimes if you want something done, you gotta do it yourself. So, patches are always welcome. If you aren't sure what exactly a "patch" is, or don't know how to generate one, but you've got code contributions to make, please don't hesitate to ask questions on the mailing lists. Patch generation and application are pretty easy thing to get the hang of, and drastically simplify code submission and review.
Please use the Issue Tracker to submit your patches. Unified contextual diffs against the latest development snapshot are preferred.
If you have commit access, then you should know what you're doing. Just make changes directly. Subscribing to the dev@ developer mailing list is recommended in any case.
Since ViewVC is used on the Internet, security is a major concern.
If you need to pass data from the request into an external program,
please don't use
You might also wish to consult the list of previously reported security vulnerabilities to get an idea of what kinds of bugs ViewVC has historically had in this area. That knowledge could just help you to avoid introducing similar problems into future releases.
If you need a new configuration option think carefully, into which
section it belongs. Try to keep the content of
Because ViewVC is a Web-based application, people will have ViewVC URLs hyperlinked from other sites, embedded in emails, bookmarked in their browsers, etc. It is very important to ensure that those URLs continue to retrieve the information they were intended to retrieve even if ViewVC is upgraded on the hosting server. In other words, as new features require modifications to the ViewVC URL schema, make sure those modifications preserve the existing functionality of all ViewVC URLs.
The library subdirectory contains a module
If a new file or module is added, a new line in the installer
Hacking on Templates
The library module