Mailing List Archive

On Apr 24, 2009, at 9:43 AM, David E. Wheeler wrote:

> [repository]: http://github.com/bricoleurs/bricolage/
>
> I'll be updating the documentation with instructions on how to use
> Git later today (hopefully), so watch for that. In the meantime, if
> you're already comfortable with GitHub, fork and hack!

I wrote up a lot of docs in the last few days and put them on the
wiki. I also moved the contents of Bric::Hacker to the wiki, and
modified it to simply point there. Here are the relevant docs:

[Working with Git](http://wiki.github.com/bricoleurs/bricolage/working-with-git
): This will get you set up with a GitHub account, fork the project,
and clone it to your local disk.

[Contributing a Bug Fix](http://wiki.github.com/bricoleurs/bricolage/contributing-a-bug-fix
): Takes you through the basic steps to fix a bug in the master
branch (formerly called trunk) and push it up to GitHub.

[Working with Branches](http://wiki.github.com/bricoleurs/bricolage/working-with-branches
): How to go about working in a maintenance branch, such as rev_1_10.

[Contributing via Email](http://wiki.github.com/bricoleurs/bricolage/contributing-via-email
): In case you don't want a GitHub account. Needs filling in by
someone who actually decides to work this way.

[Merging with Git](http://wiki.github.com/bricoleurs/bricolage/merging-with-git
): Mostly about merging from a maint branch to master.

[Starting a Project Branch](http://wiki.github.com/bricoleurs/bricolage/starting-a-project-branch
): For those of you who want to undertake some major hacking.

[Git Hacks](http://wiki.github.com/bricoleurs/bricolage/git-hacks):
Cool tricks. Please add your own!

[Creating a Release](http://wiki.github.com/bricoleurs/bricolage/creating-a-release
): How to create and test a tarball, where to upload it, and where to
send announcements. Adapted from Bric::Hacker.

[Community](http://wiki.github.com/bricoleurs/bricolage/community):
Mail lists, IRC, etc.

[Coding Standards](http://wiki.github.com/bricoleurs/bricolage/coding-standards
): For Perl, SQL, in Emacs and Vim. Adapted from Bric::Hacker.

[Contributing Actions and Movers](http://wiki.github.com/bricoleurs/bricolage/contributing-actions-and-movers
): Why don't more people do this? Adapted from Bric::Hacker.

[Debugging](http://wiki.github.com/bricoleurs/bricolage/debugging):
Adapted from Bric::Hacker.

[Performance Tuning](http://wiki.github.com/bricoleurs/bricolage/performance-tuning
): Adapted from Bric::Hacker.

I've also added a [Developer](http://wiki.github.com/bricoleurs/bricolage/development
) page to serve as a TOC for developers. It includes all the links
here (plus one more shortly based on an old [list post](http://marc.info/?l=bricolage-devel&m=121743959523650
).

So, what are you waiting for? Fork and get hacking!

Best,

David

On Tue, Apr 28, 2009 at 05:43:51PM -0700, David E. Wheeler wrote:
> On Apr 24, 2009, at 9:43 AM, David E. Wheeler wrote:
>
> >[repository]: http://github.com/bricoleurs/bricolage/
> >
> >I'll be updating the documentation with instructions on how to use
> >Git later today (hopefully), so watch for that. In the meantime, if
> >you're already comfortable with GitHub, fork and hack!

Nice work. :)

[snip]


--

Brad Harder,
Method Logic Digital Consulting
http://www.methodlogic.net

On 28-Apr-09, at 9:43 PM, David E. Wheeler wrote:

> So, what are you waiting for? Fork and get hacking!

Just as a testament to how straightforward it is to contribute now
(thanks to the updated documentation): I was able to git Bricolage out
of the repository, get it installed and running, make changes, push
those back to my GitHub account, and issue a pull request in a matter
of a couple hours last night.

So, if it's easy enough for _me_ to understand... ;-)

--
Phillip Smith // Simplifier of Technology // COMMUNITY BANDWIDTH
www.communitybandwidth.ca // www.phillipadsmith.com