These are chat archives for CenterForAssessment/NCIEA_Internship_2015

3rd
Jun 2015
Damian Betebenner
@dbetebenner
Jun 03 2015 09:05
Gretchen, Luciana, Charlie. After two nights with 4 hours of sleep, I’m going to work from home today. Let’s keep in touch via Gitter. Let’s get the GitHub client set up on your machines and make a “Hello World” gist, clone it to your computer, modify it on your computer, and push the changes back to the remote.
Damian Betebenner
@dbetebenner
Jun 03 2015 09:10
I love the term in this article on Shale oil and big data: “High iteration learning”. I mentioned agile development yesterday. Agile development is all about “high iteration learning”. Fail fast, learn, improve!
cdepascale
@cdepascale
Jun 03 2015 12:57
"Let’s get the GitHub client set up on your machines and make a “Hello World” gist, clone it to your computer, modify it on your computer, and push the changes back to the remote." - OK, so I have no idea what any of that means.
Gretchen Anderson
@ganders309
Jun 03 2015 12:59
come see us, Charlie, and we'll figure it out together.
Damian Betebenner
@dbetebenner
Jun 03 2015 12:59

OK, here’s the GitHub client:

https://windows.github.com/

Damian Betebenner
@dbetebenner
Jun 03 2015 13:09
Next, log in to your GitHub account
and click on the ‘Gist’ link which will take you to a page where you can start your Gist. You can call your gist (for example): Hello_World.md
And Gitter, being cool!, embeds the gist into Gitter!!!
On the right of the page you’ll see a button ‘Download Gist'
Damian Betebenner
@dbetebenner
Jun 03 2015 13:14
Clicking that button should open the GitHub client and prompt you to clone the gist to your computer
This can also be done via command line, but let’s just use the client for now
Gretchen Anderson
@ganders309
Jun 03 2015 13:14
@dbetebenner , should I be able to see your Gist in the repository now?
Damian Betebenner
@dbetebenner
Jun 03 2015 13:15
When you say ‘repository’, what are you referring to?
Gretchen Anderson
@ganders309
Jun 03 2015 13:15
oops. I can see tht you uploaded to dbetebenner not to NCIEA_Internship. Never mind.
Damian Betebenner
@dbetebenner
Jun 03 2015 13:17
Yes, I believe (not 100% sure) ‘Gists’ are always connected with the author. That’s how I’ve always made them. When someone asks me a question about how to run a particular SGP analysis using the R package, I create a gist with the source code to run the analysis and share the URL
Once you have a local repo (repository) for the Gist, you can open the Hello_World.md file (it’s a text file) and alter it locally. For example, add in
an emoticon :smile: Because git is looking for any changes in the local directory, your GitHub client will detect them and you can push those changes back to the GitHub gist.
Gretchen Anderson
@ganders309
Jun 03 2015 13:23
interesting, the link I posted was not the one I thought I copied.
Damian Betebenner
@dbetebenner
Jun 03 2015 13:31
Were you able to clone the Gist to your laptops?
Luciana Cançado
@lcancado
Jun 03 2015 13:32
No, trying to figure out how to make it show up in the widows client
Damian Betebenner
@dbetebenner
Jun 03 2015 13:33
You can also clone each other’s Gists. However, when you change someone elses Gist and push the change from local (your laptop) to remote (the GitHub website), the person who owns the Gist will need to review the ‘pull request’ and decide whether to accept it

@lcancado If you have the client installed, my understanding is that once you click ‘Download’, the client should open.

However, look at the preferences associated with the client and see if some defaults need to be changed to enable this activity

Damian Betebenner
@dbetebenner
Jun 03 2015 13:44
NOTE: When I try to download, it isn’t activating my client either. It just downloads a .tar.gz file (a compressed file) that when unzipped gives the folder containing the repository. One could then point the GitHub client to that folder
Luciana Cançado
@lcancado
Jun 03 2015 14:01
Do we have to create a repository and put the Gist in it? From what I read the Gist is its own repository but I can't see it anywhere in the widows client or and even in my GitHub page
Damian Betebenner
@dbetebenner
Jun 03 2015 14:03
A ‘Gist’ is a lightweight repository that is separate from your page (which contains more heavy weight repositories). The ‘Gist’ link at the top of the page will take you to your ‘Gists’.
Luciana Cançado
@lcancado
Jun 03 2015 14:06
Ok, but is there a way to make it show up in my local client? Do you have regular repositories for your Gists?
Damian Betebenner
@dbetebenner
Jun 03 2015 14:12
I do, but I usually set them up with the command line (which I don’t want to do here since we need to figure this out going forward)
Gretchen Anderson
@ganders309
Jun 03 2015 14:13
here is an update on my gist (I dumped my first one so the initial link is broken) https://gist.github.com/ganders309/8318da1bd04eee3beb71
Damian Betebenner
@dbetebenner
Jun 03 2015 14:14
Actually, one thing I just discovered is that is that when you downlaod a repository from a main branch, it does automatically open up the client. That isn’t happening for Gists

Also, there are some great Markdown references:

GitHub uses a ‘flavor’ of Markdown called (what else) GitHub flavored markdown.

https://help.github.com/articles/markdown-basics/

You can play with some of these types of Markdown in your Hello_World.md file.

Damian Betebenner
@dbetebenner
Jun 03 2015 15:15
Any luck with cloning your Gist to your laptop?
Luciana Cançado
@lcancado
Jun 03 2015 15:17
Yes, but it looks like Gists are separate from GitHub and if you are not using the command line you need a separate app to manipulate them.
I downloaded one called Gisto
There's also GistBox
Damian Betebenner
@dbetebenner
Jun 03 2015 15:19
I saw GistBox, but that looks like it edits them on GitHub, as opposed to having a local repository
Gretchen Anderson
@ganders309
Jun 03 2015 15:23
I have Damian's Gist file in my local and can edit it in notepad but I am dubious that this is working as intended.
no option to commit
Luciana Cançado
@lcancado
Jun 03 2015 15:24
I could not find any other way for my Gist to show up in the windows client. Everywhere I look people seem to provide separate code for manipulatings Gists
There's a gist code for vim
A gist code for ruby
Damian Betebenner
@dbetebenner
Jun 03 2015 15:25
Hmmmm, I’d like to find a way to do this that doesn’t rely upon the command line tools and uses a client. That will make is accessible to the “producers” we eventually want to bring on board
Luciana Cançado
@lcancado
Jun 03 2015 15:39
Not sure that will be possible. Even Mike Bostock's instructions for Mac require you to install Node and then a packege he created called gistup if you don't want to use the gist.github web editor:
http://bost.ocks.org/mike/block/
Damian Betebenner
@dbetebenner
Jun 03 2015 16:04
So I was able to confirm that I can create a local repo from the Gist via my standard way of doing things and then update locally and push those changes back to the Gist on GitHub (I added an emoticon). However, it did require me to enter my username and password (as opposed to recognizing my security token by default)
Damian Betebenner
@dbetebenner
Jun 03 2015 16:27
It doesn’t look like the GitHub client is going to help us with mangaging Gists.
Damian Betebenner
@dbetebenner
Jun 03 2015 16:40
I just installed Gisto which also allows for robust editing synced with GitHub without the local repo. I recommend we play with that and forego the local repo for a little while and see just how necessary it is going forward. Thoughts?
Gisto has a markdown previewer which is really nice
Damian Betebenner
@dbetebenner
Jun 03 2015 17:57
Nice, I wasn’t aware of the “check box” feature in Markdown
Gretchen Anderson
@ganders309
Jun 03 2015 18:08
so, @dbetebenner , I made a fork from your gist a while back and uploaded it for your review and approval. Did you ever see that show up in your environment?
Damian Betebenner
@dbetebenner
Jun 03 2015 18:16
I see you forked it, and I see your revisions to your fork. I’m beginning to wonder whether multiple people can work on a single Gist (like one can with other repositories) and people can make pull requests that you can accept/reject.
The options for Gists seem to be work on yours or fork someone elses and work on that.
Luciana Cançado
@lcancado
Jun 03 2015 18:17
It seems to me Gists are linked to our individual accounts and that any changes made by other people would have to be approved somehow by the Gist creator. This would make the collaboration process kind of clunky.
Damian Betebenner
@dbetebenner
Jun 03 2015 18:18
I was just looking at the same thing :smile:
Gretchen Anderson
@ganders309
Jun 03 2015 18:25
Can we colaborate in GitHub and then publish the final modual as a Gist?
Damian Betebenner
@dbetebenner
Jun 03 2015 18:28
Not sure. If we can, I’m not sure whether that workflow will become excessively complicated
Damian Betebenner
@dbetebenner
Jun 03 2015 18:34
That may be something to discuss with Ben. Should an assessment literacy module be an actual repo or a Gist? What are the use cases we envision?
Gretchen Anderson
@ganders309
Jun 03 2015 18:35
define "assessment literacy module" for me again.
Damian Betebenner
@dbetebenner
Jun 03 2015 18:38

A standalone ‘module’ explaining a topic of interest to a user. The NCME RFP indicates some pretty BIG submodules http://d31hzlhk6di2h5.cloudfront.net/20150506/65/10/82/2a/d7c0aec6745a7ab41c28fe2c/NCME_RFP_for_Assessment_Literacy_Materials_FINAL.pdf

I always think of something like “measurement error” as a topic that can be discussed in a ‘module’ that the user can get through quickly

Note (Charlie) Gitter has a iPhone and Android app so we can chat constantly :clap:
Gretchen Anderson
@ganders309
Jun 03 2015 18:45
Damian Betebenner
@dbetebenner
Jun 03 2015 18:51
Also, I don’t want to discourage you from learning the command line tools (CLTs). However, it’s my goal to be able to set up a working environment without learning them. I’ve found that CLTs are a barrier to entry that few overcome. For you two, being able to utilize both would be ideal
Gretchen Anderson
@ganders309
Jun 03 2015 20:11
Here is a site that leverages GitHub to help journalists develop visualizations. http://jlord.us/sheetsee.js/#possibilities
Gretchen Anderson
@ganders309
Jun 03 2015 20:37
Damian Betebenner
@dbetebenner
Jun 03 2015 20:39
Cool. That’s the static website part of Github. Here’s the one for the SGP package: www.sgp.io