A playground for learning the basics of contributing to a project on Github.
This repo is designed to teach baseline skills to folks who are not interested in installing anything addition on their computers. It limits its scope to those tasks which are achievable entirely in-browser, or which can be done using web-interface file uploads of files which can be built on almost any computing device (CSV files).
Thorough exploration of this repo & the tasks associated with it should give praxis and skill training to students. Desired Learning Outcomes:
- Register a Github Account and know how to get other folks registered for their own accounts.
- Request to become a contributor to Code for Pittsburgh, and get approved.
- Navigate a repository from its front page (and Readme).
- Make rudimentary contributions directly from the web interface, using the New File, Upload Files, and Edit//Pencil buttons.
- Perform their own Field Survey with a fellow brigade member
- Contribute that Field Survey directly to the repo.
- Use other tools to create large datasets, and upload those datasets as batched CSV files.
Interviews contains an open forum for trying out a few easy methods of data collection. The themed activity which relates to it is the interviewing of other humans about their childhood play places, with a focus on places that no longer exist, or have been altered significantly from how they were when they were young. This can be done through introspection, if other people are not available.
Other folders will be noted here as they are added.
Republished from Code for Anchorage.
A training project for GitHub.
- Download the app using the appropriate link below:
- Windows: http://windows.github.com/
- Mac: http://mac.github.com/
It is a web-based hosting service for software development projects using the Git revision control system. Stolen from wikipedia.
Are you familiar with Wikipedia? People from all over the world are able to edit, view, and add to the information on Wikipedia. Github is a similar concept.
- Central Access: As long as someone has internet access, she can access the project.
- Track Changes: Using git, you can see the history of changes made to a file.
- Collaboration: Others can use your project as a starting point for their own efforts, or contribute to yours. With git, merging your changes with other people's changes is simplified.
Git is a version control system, a way to manage changes to documents. Git is how we track and manage files, github is where we store a project and collaborate.
- Local Repository: Collection of documents on your local machine.
- Remote Repository: Collection of documents on another machine.
- Commit: Snapshot of changes to a document.
- Sync: Push and pull changes with a remote repository.
It's free for projects that are public for all to see. It's a good place for people to give you feedback, potential employers to check out your work, and to store our work as we learn.
Click into the folders and follow the readmes there to perform a series of structured activities within the repository. Each of the folders contains its own readme file, with its own explanation of the the curriculum offered, the activities involved, and the methods of performing them.
Feel free to clone or fork this repo. Adapt it for your own use. Put it in your book. Add it to your project.
Code for Pittsburgh documentation is always CC Zero. In plain speech, this means that it is public domain knowledge. Universally accessible, common heritage. Use it in whatever way you wish.
"These fragments I have shored against my ruins"