Skip to content

Developer Information

rmandelb edited this page Mar 20, 2013 · 11 revisions

This is a page where we're collecting useful links and information for GalSim developers.

Repository information

The devel/ directory in the repository itself has a number of useful documents for developers. In particular, git.txt has a guide on Git usage (in general, and also the specifics of work-flow for this repository, guidelines on branch names, etc.). Developers might find the section at the end, "Putting git status info in your prompt", to be especially useful.

Also in devel/ are:

  • credo.txt: some style guidelines for naming of functions, tabs vs. spaces in code (the answer: no tabs!), etc.

  • c.vim: a file to make vim use our style guidelines

  • commit-msg: see comments at top for how to use. This file can be used to make git append the issue number to each commit on a branch associated with that issue, so that the commit shows up on the GitHub issue page. Very useful!

  • doxygen_readme.txt: comments on the Doxygen documentation system

Documents describing tasks for GalSim developers

Barney and Rachel have put together draft documents describing the main tasks that need to be addressed in the GalSim project, and split these into three broad topics:

System-wide GalSim tasks document

Code module GalSim tasks document

Inputs for GalSim tasks document

These short descriptions are not meant to be exhaustive / authoritative, but to give a guide as we begin to allocate work and responsibilities across the GalSim-developers team more broadly. Please take a look, and see what tasks interest you!

We've also made a preliminary, open-to-change-and-discussion assignment of names to these responsibilities: Names ... Definitely please check that out and see if works for you.