BitBucket Basics / Git Tips

Dan Rathbun

BitBucket Basics / Git Tips

Set up my first Git repo at BitBucket, (and although I am going through the Tutorial,) I'd like to create this topic here for tips on using Git and/or BitBucket, to develop a project specifically for SketchUp Ruby.

Dan Rathbun

First question... what should the Wiki page be ?

If I create a README at the top of the Git repo, is it displayed as the Wiki by default. (And conversely, if I edit the Wiki manually, is it saved as as the README file ??)

I know there needs to be project introduction, and I'd also like somewhere to list the goals of the project for first release at v1.0.0, and it seems like this is a good place.

But also... since this is a library project, .. we need a place to display the API (whether manually written, or RDoc generated. And the Wiki seems also to be a nice place for this, (but maybe I am missing some Documentation feature of BitBucket ??)

Dan Rathbun

It seems the project / repos are missing a discussion feature, where general issues or strategy for the project can be discussed.

I would not think we would wish to fill up the Issues List will this kind of general discussion.

So we'd need to create either a GoogleGroup, or a Beta Forum here at SCF, for the project ??

Dan Rathbun

Local Repo / Plugin Testing Syncronization

OK, I followed the Tutorial and made my "repos" dir in my HOME dir.

Created (cloned) the project in that dir, let's call it "repos/proj"

Previously, I was working on my project in a subdir of SU's "Plugins" dir. This makes it handy for loading and debugging.

So I manually copied the entire project dir hierarchy to "~/repos/proj" and used the Git GUI to commit and push the first version of the code to the online Git repo at BitBucket.

All seems well so far.

But now, I need to continue editing the code, testing it, and pushing updates.

The question is... do I work on the set under the "SketchUp/Plugins" dir, and manually copy to the local repo, or reset my Notepad++ session to open files from the "~/repos/proj" dir instead ??

I imagine that I can put a script in the "Plugins" dir, that appends the path File.expand_path("~/repos/proj") to Ruby's $LOAD_PATH array, so I can load and debug directly from there.

Is this what others are doing when they use Git for SketchUp Ruby development ???

thomthom

I like to use the Issues BitBucket service on my repos - so I can mark issues as solved on push.
https://confluence.atlassian.com/display/BITBUCKET/Setting+Up+the+Bitbucket+Issues+Service

Dan Rathbun

Great Idea, I was wondering how to do that. Done.