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).