{"action":"created","issue":{"url":"https://api.github.com/repos/programminghistorian/jekyll/issues/158","labels_url":"https://api.github.com/repos/programminghistorian/jekyll/issues/158/labels{/name}","comments_url":"https://api.github.com/repos/programminghistorian/jekyll/issues/158/comments","events_url":"https://api.github.com/repos/programminghistorian/jekyll/issues/158/events","html_url":"https://github.com/programminghistorian/jekyll/pull/158","id":118888913,"number":158,"title":"Create getting_started_with_palladio","user":{"login":"wcaleb","id":1126864,"avatar_url":"https://avatars.githubusercontent.com/u/1126864?v=3","gravatar_id":"","url":"https://api.github.com/users/wcaleb","html_url":"https://github.com/wcaleb","followers_url":"https://api.github.com/users/wcaleb/followers","following_url":"https://api.github.com/users/wcaleb/following{/other_user}","gists_url":"https://api.github.com/users/wcaleb/gists{/gist_id}","starred_url":"https://api.github.com/users/wcaleb/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/wcaleb/subscriptions","organizations_url":"https://api.github.com/users/wcaleb/orgs","repos_url":"https://api.github.com/users/wcaleb/repos","events_url":"https://api.github.com/users/wcaleb/events{/privacy}","received_events_url":"https://api.github.com/users/wcaleb/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/programminghistorian/jekyll/labels/submission","name":"submission","color":"eb6420"}],"state":"open","locked":false,"assignee":{"login":"acrymble","id":646647,"avatar_url":"https://avatars.githubusercontent.com/u/646647?v=3","gravatar_id":"","url":"https://api.github.com/users/acrymble","html_url":"https://github.com/acrymble","followers_url":"https://api.github.com/users/acrymble/followers","following_url":"https://api.github.com/users/acrymble/following{/other_user}","gists_url":"https://api.github.com/users/acrymble/gists{/gist_id}","starred_url":"https://api.github.com/users/acrymble/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/acrymble/subscriptions","organizations_url":"https://api.github.com/users/acrymble/orgs","repos_url":"https://api.github.com/users/acrymble/repos","events_url":"https://api.github.com/users/acrymble/events{/privacy}","received_events_url":"https://api.github.com/users/acrymble/received_events","type":"User","site_admin":false},"milestone":null,"comments":7,"created_at":"2015-11-25T17:41:59Z","updated_at":"2015-12-05T17:57:30Z","closed_at":null,"pull_request":{"url":"https://api.github.com/repos/programminghistorian/jekyll/pulls/158","html_url":"https://github.com/programminghistorian/jekyll/pull/158","diff_url":"https://github.com/programminghistorian/jekyll/pull/158.diff","patch_url":"https://github.com/programminghistorian/jekyll/pull/158.patch"},"body":"@miriamposner originally wrote this as a workshop, but Adam thought maybe we should publish it on PH."},"comment":{"url":"https://api.github.com/repos/programminghistorian/jekyll/issues/comments/162230997","html_url":"https://github.com/programminghistorian/jekyll/pull/158#issuecomment-162230997","issue_url":"https://api.github.com/repos/programminghistorian/jekyll/issues/158","id":162230997,"user":{"login":"acrymble","id":646647,"avatar_url":"https://avatars.githubusercontent.com/u/646647?v=3","gravatar_id":"","url":"https://api.github.com/users/acrymble","html_url":"https://github.com/acrymble","followers_url":"https://api.github.com/users/acrymble/followers","following_url":"https://api.github.com/users/acrymble/following{/other_user}","gists_url":"https://api.github.com/users/acrymble/gists{/gist_id}","starred_url":"https://api.github.com/users/acrymble/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/acrymble/subscriptions","organizations_url":"https://api.github.com/users/acrymble/orgs","repos_url":"https://api.github.com/users/acrymble/repos","events_url":"https://api.github.com/users/acrymble/events{/privacy}","received_events_url":"https://api.github.com/users/acrymble/received_events","type":"User","site_admin":false},"created_at":"2015-12-05T17:57:30Z","updated_at":"2015-12-05T17:57:30Z","body":"Thanks for this submission @miriamposner. This looks like an excellent workshop-style lesson, which I think will be very useful, and I hope to try it out with my own students. I've had a read through and tried it out, and I've got a few points I'd like to suggest/discuss before I send it to some reviwers for testing.\r\n\r\nStarting with the easy bits.\r\n\r\nYou have a typo: 'Description from Slide Note' should read 'Description from Slide Mount'\r\n\r\nMinor bug: The timeline feature doesn't work in Firefox on Mac. Nothing we can do about that, but if you could flag that for people that would be helpful.\r\n\r\nNot sure if bug: When you load the gallery feature, if you havn't set your categories to load the image, clicking on the spot where the image should have been sent me back to the Palladio homepage, and I lost my work. A warning there might be a good idea.\r\n\r\nUsability point: You mention a lot of tools, especially in the intro. Can you link out to these please? Likewise, there are a couple of relevant PH lessons that it would be good to point out to readers. Especially:\r\n\r\n* http://programminghistorian.org/lessons/cleaning-data-with-openrefine\r\n* http://programminghistorian.org/lessons/creating-network-diagrams-from-historical-sources\r\n\r\nThinking about potential problems: can you make a comment on data types and cleaning data before Palladio? I imagine some people won't know that a computer requires 'dates' in a certain format, or that 'text' or 'georeferences' also have to follow certain rules. For example, if one of your dates was formatted incorrectly, what would happen to Palladio? How do I know if my data is ready?\r\n\r\n---\r\n\r\n1) More generally, I think it would be really helpful for students and historians if the lesson emphasised the way that this tool lets you get to know your sets of structured, digital, historical sources (as you note in the comment above), and maybe learn something about those sources that's difficult to do when staring at a spreadsheet. A paragraph to start off along the lines of 'who is this useful for?' that thinks of the audience as a historian who works with 'sources' rather than a DHer who thinks in terms of 'data' would be a good way to increase the accessibility of the lesson and to broaden the audience. A change in the title would probably help with that shift in emphasis. Maybe something like: getting to know geo-temporal datasets using Palladio? Open to ideas, of course.\r\n\r\n2) You've given us a really rich dataset here, which is a fantastic choice for this tool. But we don't really take the time to get to know it, or to know what a tool like this might help us discover. What do you think about spoiling the lesson and showing us what we're going to find right away, to hook the reader into finding out how to make that discovery?\r\n\r\n3) It might also be helpful to give us a pared-down version of the data (which we should store with the lesson in case the dropbox version disappears). You've got a lot of columns that don't come into the lesson, some of which have fairly ambiguous column titles that aren't immediately obvious to a person who hasn't used this dataset before. Would it be easier for a new user if they were just removed before we got going? That way you could send them into the csv file before jumping into Palladio. That way they act as a historian: getting to see what they can understand, before moving to the digital tool to see how that makes things easier/different. That might help them know if their own data is a good fit and therefore if they want to keep reading.\r\n\r\n4) The sections are great and your examples are awesome. I think I would have found it helpful for you to have your historians' hat on a bit more throughout, telling us WHY we're choosing certain facets or choices for the various categories so that I understand them well enough to use them on my own data. But also interpreting what we're finding with this that makes this experience worthwhile. Can you help us discover something within the data that we wouldn't otherwise find? Give us that eureka! moment? I'm thinking of a group of students here, but I think it would be really awesome to send them in to explore the dataset in Excel, ask them what they can find, and then have a series of meaningful historical discoveries that emerge as if by magic through each of the various tools (map, timeline, facets, gallery, etc). That might be tricky, but let me know what you think.\r\n\r\nI hope that's helpful as a starting point for a conversation. This looks like a great tool that I hadn't used before, and I plan to try this lesson out with my students. So please let me know your thoughts on these areas. From what I see, it looks like a bit of flushing out rather than major changes, are what would make this a really fantastic piece."}}