[{"data":1,"prerenderedAt":411},["ShallowReactive",2],{"project-20698966":3},{"id":4,"name":5,"line":6,"line_source":7,"title":8,"url":9,"domain":10,"maker":11,"posted_at":12,"year":13,"points":14,"comments":15,"rank_in_year":16,"shown_in_year":17,"top":18,"tier":19,"category":20,"subcategory":21,"format":22,"keywords":23,"reception":28,"sentiment":29,"stance_mix":30,"scored_comments":34,"aspects":35,"strip":45,"post_text":48,"what":49,"said":81,"maker_in_thread":201,"shape":212,"grid":215,"attempts":375,"same_week":376,"maker_shows":38,"maker_hidden":403,"reader_version":404,"card":405},"20698966","StoryTime","Create stories about your code instead of documentation","title","Show HN: StoryTime – Create stories about your code instead of documentation","https:\u002F\u002Fstorytime.dev","storytime.dev","vidoss",1565810338,2019,193,67,197,2195,9,"notable","dev_tools","code explainer","web_app",[24,25,26,27],"code walkthrough","code annotation","code documentation","code presentation","debated",-0.048,{"positive":31,"neutral":18,"mixed":32,"critical":33},12,4,14,39,{"idea":36,"design":39,"execution":42,"docs":44},{"positive":37,"critical":38},7,1,{"positive":40,"critical":41},2,11,{"positive":43,"critical":40},0,{"positive":43,"critical":43},[46,47,46,46,38,38,43,47,47,47,43,38,43,47,46,46,38,47,47,47,47,38,38,38,38,46,46,38,47,38,46,46,38,43,43,46,47,47,46,43],5,3,null,{"problem":50,"audience":60,"pricing":69,"motivation":48,"time_to_build":48,"stack":78,"openness":79,"stage":80,"team_size":79},{"value":51,"source":52,"evidence":53},"Explaining code in docs is hard to follow; step-by-step annotated walkthroughs are an alternative","maker",[54,56],{"id":55},"post",{"id":57,"by":58,"text":59},"20699531","sequoia","I like this mode of explaining code things by slowly building up & talking through examples. I have been doing this in talks for a while to go over code bit by bit without…",{"value":61,"source":62,"evidence":63},"developers explaining code to others","inferred",[64,65],{"id":57,"by":58,"text":59},{"id":66,"by":67,"text":68},"20699726","freehunter","I love this. This is how I document my side projects, I tend to write long stories to myself with chunks of code thrown in for clarity. This is much more elegant though.",{"value":70,"source":52,"evidence":71},"free for public repos; private repos via a GitHub Marketplace app planned",[72,75],{"id":73,"by":11,"text":74},"20699370","Current plan is to make this available for free to public repos. Will be adding an app in github marketplace for private repos. Code will be open sourced after some cleanup.",{"id":76,"by":11,"text":77},"20699658","private repo is in the works. Will be available as an app in github marketplace. Bitbuket and gitlab support coming soon. You can sign up to be notified here.…",[],"unknown","beta",{"praise":82,"objections":97,"requests":146,"questions":177,"alternatives":192},[83],{"value":84,"source":85,"evidence":86},"Useful concept for explaining code step by step","commenter",[87,88,92,96],{"id":57,"by":58,"text":59},{"id":89,"by":90,"text":91},"20699657","brnkrygs","Very interesting concept, thanks for sharing! Context and intent are critical when trying to understand code - this looks like a useful way to capture that. Merging the call…",{"id":93,"by":94,"text":95},"20700820","jedberg","This is very cool. This is basically what I do when I'm making a presentation and talking about a block of code (albeit with a ton of work in Keynote to make it easy to follow).…",{"id":66,"by":67,"text":68},[98,117,135],{"value":99,"source":85,"evidence":100},"Commentary text sits too far from the code being explained",[101,105,109,113],{"id":102,"by":103,"text":104},"20699500","cabaalis","It may be a good idea to move the story text closer to the code. On a large monitor, I have to move my eyes quite a bit and it feels disconnected.",{"id":106,"by":107,"text":108},"20699813","Kiro","The story text at the bottom is too far away from the code for me so I constantly need to \"switch\" between them and I don't have time to read both. Any reason for not putting it…",{"id":110,"by":111,"text":112},"20700707","whoisjuan","The text snacks should show up next to the code. Not fixed to the bottom. It makes it hard to follow.",{"id":114,"by":115,"text":116},"20699903","vlucas","+1 - came here to say this. I love the idea, but the text block at the bottom of the screen and the corresponding code at the top left is a bit of a pain to go back and forth to…",{"value":118,"source":85,"evidence":119},"Playback advances too fast to read; prefer manual pause\u002Fadvance",[120,124,127,131],{"id":121,"by":122,"text":123},"20699045","scott_s","I think that the default behavior should be that the user has to click or press the keyboard to progress the story. I started reading one of the stories, and it quickly went…",{"id":125,"by":122,"text":126},"20699127","I think that pause-by-default is more important than keyboard support. Put another way, I don't think that \"play\" as in \"play a movie\" is the right metaphor. I think that by…",{"id":128,"by":129,"text":130},"20705551","joshstrange","It moves a little too fast for me to read the message (bottom of my screen) and then flick my eyes back up to the code and internalize what it's doing. I'd prefer speed controls…",{"id":132,"by":133,"text":134},"20701906","broth","Very interesting concept. I found that the transitions were too quick for me to read the descriptions at the bottom of the page. It might be nice to set this transition interval…",{"value":136,"source":85,"evidence":137},"Name oversells it; these are explanations rather than stories",[138,142],{"id":139,"by":140,"text":141},"20703693","dakom","Innovative ways to explain code is a great idea and I love the project. However, I don't love the name. These are explanations - not stories (unless we consider stories as being…",{"id":143,"by":144,"text":145},"20718300","LyndsySimon","I get where you're coming from, but \"story\" here seems more akin to a \"user story\" than literature. User stories have been used for quite a long time for both software…",[147,154,165,169],{"value":148,"source":85,"evidence":149},"Keyboard controls and pause-by-default",[150,153],{"id":151,"by":11,"text":152},"20699067","Good point. Will add keyboard support.",{"id":128,"by":129,"text":130},{"value":155,"source":85,"evidence":156},"Support for Bitbucket and GitLab",[157,161],{"id":158,"by":159,"text":160},"20699624","WrtCdEvrydy","Everything is about this is amazing except for 2 small things. 1) Not sure about private repos 2) I'm sure it doesn't work against bitbucket :(",{"id":162,"by":163,"text":164},"20705529","FascistDonut","Another Bitbucket vote here. Subscribed.",{"value":166,"source":85,"evidence":167},"Private repo support",[168],{"id":158,"by":159,"text":160},{"value":170,"source":85,"evidence":171},"Show code history over time via commit diffs",[172,173],{"id":89,"by":90,"text":91},{"id":174,"by":175,"text":176},"20704774","hsndmoose","Yeah watching a section of code over time was what I thought this was going to be initially. That sounds really useful for sharing the story of \"how we got here\" to new devs.",[178,185],{"value":179,"source":85,"evidence":180},"Is it open source or commercial?",[181],{"id":182,"by":183,"text":184},"20699312","MFLoon","This is awesome, I've wanted a similar tool before. Is this open source or are you planning to commercialize? One bit of UX feedback - the modal with the commentary text is a bit…",{"value":186,"source":85,"evidence":187},"What happens to stories when code changes?",[188],{"id":189,"by":190,"text":191},"20699005","billconan","so, what if my code has changed, will an old story matches the new code? a related project you might be interested in https:\u002F\u002Fourcodestories.com\u002F",[193,197],{"value":194,"source":85,"evidence":195},"ourcodestories.com",[196],{"id":189,"by":190,"text":191},{"value":198,"source":85,"evidence":199},"Presentation slides with code fade-ins",[200],{"id":57,"by":58,"text":59},{"comments":202,"answered":203,"key":204},20,6,[205,208,209],{"id":206,"text":207},"20699570","Thanks for sharing. This gives me some target use case to work towards.",{"id":76,"text":77},{"id":210,"text":211},"20698993","Hi, OP here. Would love to get some feedback from HN community.",{"commenters":213,"max_depth":203,"maker_replies":202,"first_comment_mins":47,"lifespan_hours":214},38,71,[216,218,220,222,223,226,227,229,231,234,238,239,241,244,246,248,249,251,254,257,260,262,265,267,269,271,273,274,277,280,283,285,288,290,292,295,298,299,301,303,304,307,308,310,314,316,319,322,324,328,330,331,334,335,336,341,344,346,348,351,354,356,361,366,369,371,373],[57,43,46,217,58,43],"project\u002Fpositive\u002Fidea",[206,43,43,219,11,38],"maker\u002Fneutral\u002Fnone",[158,43,47,221,159,43],"project\u002Fmixed\u002Fnone",[76,43,43,219,11,38],[224,43,46,225,159,43],"20699669","project\u002Fpositive\u002Fnone",[162,43,46,225,163,43],[139,38,38,228,140,43],"project\u002Fcritical\u002Fidea",[143,38,43,230,144,43],"commenter\u002Fneutral\u002Fnone",[232,38,43,233,140,43],"20725524","commenter\u002Fcritical\u002Fidea",[235,40,38,236,237,43],"20700613","project\u002Fcritical\u002Fdesign","simplify",[210,47,43,219,11,38],[189,47,47,240,190,43],"project\u002Fneutral\u002Fexecution",[242,47,43,243,11,38],"20699080","maker\u002Fneutral\u002Fexecution",[121,47,47,245,122,43],"project\u002Fneutral\u002Fdesign",[151,47,43,247,11,38],"maker\u002Fneutral\u002Fdesign",[125,47,47,245,122,43],[250,47,43,247,11,38],"20699178",[252,47,43,253,122,43],"20699255","commenter\u002Fneutral\u002Fdesign",[255,47,47,245,256,43],"20700908","loco5niner",[258,47,38,236,259,43],"20699128","merlincorey",[261,47,43,247,11,38],"20699203",[263,47,47,245,264,43],"20699086","CamelCaseName",[266,47,43,247,11,38],"20699135",[182,47,46,268,183,43],"project\u002Fpositive\u002Fdesign",[73,47,43,270,11,38],"maker\u002Fneutral\u002Fpricing",[272,47,46,225,183,43],"20699391",[102,47,38,236,103,43],[275,47,38,236,276,43],"20699522","azhenley",[278,47,38,236,279,43],"20699533","kaibee",[281,47,46,217,282,43],"20699718","michaelmarion",[114,47,47,284,115,43],"project\u002Fmixed\u002Fdesign",[286,47,47,284,287,43],"20699774","Lerc",[289,47,43,219,11,38],"20700027",[291,47,43,247,11,38],"20700098",[293,47,47,294,287,43],"20701126","project\u002Fmixed\u002Fdocs",[296,47,38,236,297,43],"20702520","kstenerud",[106,32,38,236,107,43],[300,32,43,247,11,38],"20699851",[302,32,38,236,163,43],"20705553",[128,46,38,236,129,43],[305,203,38,306,144,43],"20718344","project\u002Fcritical\u002Fexecution",[93,37,46,217,94,43],[309,37,43,219,11,38],"20701229",[311,312,46,268,313,43],"20699925",8,"localhost",[315,312,43,247,11,38],"20699994",[317,312,38,236,318,43],"20700364","euph0ria",[320,18,47,245,321,43],"20701128","memco",[323,18,43,247,11,38],"20701205",[325,326,38,306,327,43],"20699497",10,"scarejunba",[329,326,43,243,11,38],"20699504",[89,41,46,217,90,43],[332,41,43,333,11,38],"20699700","maker\u002Fneutral\u002Fidea",[174,41,46,217,175,43],[110,31,38,236,111,43],[337,338,43,339,340,43],"20699342",13,"other\u002Fneutral\u002Fnone","tomcooks",[342,338,43,339,343,43],"20699394","duxup",[345,338,43,339,11,38],"20699431",[347,338,43,339,11,38],"20699444",[349,338,43,339,350,43],"20701048","tighter_wires",[352,33,46,217,353,43],"20700826","KaoruAoiShiho",[132,355,47,245,133,43],15,[357,358,47,359,360,43],"20704139",16,"project\u002Fneutral\u002Fidea","lpellis",[362,363,47,364,365,43],"20699166",17,"project\u002Fneutral\u002Fdocs","lkschubert8",[367,363,43,368,11,38],"20699187","maker\u002Fneutral\u002Fdocs",[66,370,46,217,67,43],18,[372,370,43,230,190,43],"20699790",[374,370,43,230,67,43],"20701039",[],[377,381,386,390,394,399],{"id":378,"name":379,"points":380,"category":20},"20688044","Divjoy",511,{"id":382,"name":383,"points":384,"category":385},"20687398","Yack",246,"productivity",{"id":387,"name":388,"points":14,"category":389},"20645319","Python re(gex)?","learning_science",{"id":391,"name":392,"points":393,"category":20},"20653942","Tailwind.run",181,{"id":395,"name":396,"points":397,"category":398},"20653278","haskell-poker",157,"games",{"id":400,"name":401,"points":402,"category":385},"20670039","Personal Management System",153,false,"v2",{"id":406,"name":5,"line":6,"ai":403,"cat":20,"year":13,"points":14,"comments":15,"rec":28,"s":407,"top":18,"kw":408,"maker":11,"domain":10,"tier":19,"attempts":43,"strip":409,"url":9,"mix":410,"praise":84,"objection":99,"sub":21},20698966,-0.05,[24,25,26,27],"5355110333010355133331111551315510053350",[31,18,32,33],1794036579880]