
# Welcome to the "Shed"

For me, a shed is a place to put build, learn and ideally make something useful.

This git repository is a "fit for purpose" interpretation of a shed. Our community routinely discuss our shared interests in person and online. We do our best to demonstrate our personal projects, either by way of demonstration or with code snippets pasted in forum posting. We now have a place to publish demonstrations that we can compliment with a discussion on our Discourse forum.

# Folder Layout

The loose convention is that the first level folder names correspond to the Discourse handle of the owner. My contributions for example are under `jdownie`. Under that will be a folder for each area of interest. For example, I have written for myself a script that helps me work in numerous `git` repositories across multiple machines. That script is called `repo`, so i'm hosting it in the `jdownie/repo` folder.

That `repo` folder for example, not only contains the script itself, but a `README.md` to explain it in more detail and an example configuration file.

# How and Why I moved `repo` to the Shed

I once hosted and maintained that script in my own personally hosted repository. I have "moved it into the shed" so that others can either use it directly, or copy and experiment on their own copy. Another community member, `tdurden` might take interest in that script. They'd create `tdurden/repo` and clone `jdownie/repo` into it. From this point, `tdurden` might make improvements and discuss them with `jdownie` on Discourse. `jdownie` might like to adopt those improvements, and with `diff` and a little care, migrate those changes back into `jdownie/repo`. Alternatively, `tdurden` might break their copy, and ask `jdownie` to take a look in the shed to help out.

I'm using `repo` as an illustration of what i hope we can accomplish with this "shed" idea. Others might start to maintain their `ansible` playbooks or `docker-compose.yaml` files for example. It's really just a shared folder. `git` makes it a bit more structured and transactional than a `Dropbox` folder (for example).

