Difference between revisions of "One recommended tool/resource for n00bs"

From Code4Lib
Jump to: navigation, search
(Software)
(added link to Jenn Riley's Seeing Standards site)
 
(18 intermediate revisions by 7 users not shown)
Line 8: Line 8:
  
 
=====Books or Things to read=====
 
=====Books or Things to read=====
* O'Reiley Head first series
+
* O'Reilly Head first series
*Visual QuickStart Guides http://www.peachpit.com/imprint/series_detail.aspx?ser=335245
+
* Visual QuickStart Guides http://www.peachpit.com/imprint/series_detail.aspx?ser=335245
*[https://docs.google.com/spreadsheet/ccc?key=0AlVSWa90m8umdGg3U0h4bjdMT0ttVUJBU3RCaUc0WGc#gid=0 QA Collection Purchases for Code4Lib]
+
* [https://docs.google.com/spreadsheet/ccc?key=0AlVSWa90m8umdGg3U0h4bjdMT0ttVUJBU3RCaUc0WGc#gid=0 QA Collection Purchases for Code4Lib]
 +
* [http://www.worldcat.org/title/pragmatic-programmer-from-journeyman-to-master/oclc/42038638 "The Pragmatic Programmer"] by Andrew Hunt and David Thomas. A book that teaches beginners how think like a programmer, and reminds experts of good practices.
 
* The top 9 in a hacker's bookshelf: http://grokcode.com/11/the-top-9-in-a-hackers-bookshelf/
 
* The top 9 in a hacker's bookshelf: http://grokcode.com/11/the-top-9-in-a-hackers-bookshelf/
 
* "How to Design Programs" http://www.ccs.neu.edu/home/matthias/HtDP2e/.  Good for newbie coders.
 
* "How to Design Programs" http://www.ccs.neu.edu/home/matthias/HtDP2e/.  Good for newbie coders.
* Kernighan and Ritchie's [http://www.worldcat.org/title/c-programming-language/oclc/17650642 "The C Programming Language."]  A keeper for life, and surprisingly readable and directed to the newbie. Also [http://www.worldcat.org/title/pragmatic-programmer-from-journeyman-to-master/oclc/42038638 "The Pragmatic Programmer"] by Andrew Hunt and David Thomas.
+
* Kernighan and Ritchie's [http://www.worldcat.org/title/c-programming-language/oclc/17650642 "The C Programming Language."]  A keeper for life, and surprisingly readable and directed to the newbie.
 +
* [http://www.worldcat.org/title/agile-web-development-with-rails-4/oclc/852808602&referer=brief_results Agile Web Development with Rails 4] is a well-paced introduction to Rails and Ruby. Covers a lot of core concepts (MVC, agile development, testing, AJAX).
 +
** To dive further into Ruby, there's [http://www.worldcat.org/title/programming-ruby-19-20-the-pragmatic-programmers-guide/oclc/855706057&referer=brief_results Programming Ruby] (aka The PickAxe Book)
 
* http://www.w3.org/International
 
* http://www.w3.org/International
 
* Guide for the Perplexed on the code4lib wiki: http://wiki.code4lib.org/index.php/A_Guide_for_the_Perplexed
 
* Guide for the Perplexed on the code4lib wiki: http://wiki.code4lib.org/index.php/A_Guide_for_the_Perplexed
Line 22: Line 25:
 
* Vi- because it keeps me (you?) focused.
 
* Vi- because it keeps me (you?) focused.
 
* [http://www.activestate.com/komodo-edit Komodo Edit]
 
* [http://www.activestate.com/komodo-edit Komodo Edit]
 +
* [http://notepad-plus-plus.org/ Notepad++ IMO best open source lightweight editor on Windows]
 
*AMP (LAMP, WAMP, MAMP) stacks for an easy install of Apache, mySQL + perl/ python / php.
 
*AMP (LAMP, WAMP, MAMP) stacks for an easy install of Apache, mySQL + perl/ python / php.
 
*A @rdio subscription. :) And a text editor with syntax highlighting.
 
*A @rdio subscription. :) And a text editor with syntax highlighting.
* Git or Github  
+
* Git (Version Control)
 +
* Github, Bitbucket and Other Remote Git Services
 
* Emmet, http://docs.emmet.io/ (supersedes Zen Coding, http://code.google.com/p/zen-coding/ ) The idea is that it lets you use CSS-like selectors as tags that can be expanded into full HTML snippets.  
 
* Emmet, http://docs.emmet.io/ (supersedes Zen Coding, http://code.google.com/p/zen-coding/ ) The idea is that it lets you use CSS-like selectors as tags that can be expanded into full HTML snippets.  
 +
* [http://sass-lang.com/ SASS Syntactically Awesome Stylesheets]
 
* LESS http://lesscss.org/   
 
* LESS http://lesscss.org/   
 +
* Compass http://compass-style.org/ - extends SASS with reusable patterns
 
* BareBones's [http://www.barebones.com/products/bbedit/index.html BBEdit]
 
* BareBones's [http://www.barebones.com/products/bbedit/index.html BBEdit]
 
* Sublime Text & Zen Coding (recently reborn as [http://docs.emmet.io Emmet]). Saves a lot of keystrokes when writing web content.
 
* Sublime Text & Zen Coding (recently reborn as [http://docs.emmet.io Emmet]). Saves a lot of keystrokes when writing web content.
Line 34: Line 41:
  
 
=====Websites=====
 
=====Websites=====
*Code4Lib listserv, IRC, [http://journal.code4lib.org journal] (duh)
+
* Code4Lib listserv, IRC, [http://journal.code4lib.org journal] (duh)
 
* Google is more useful than any reference book to find answers to programming problems.
 
* Google is more useful than any reference book to find answers to programming problems.
* [http://stackoverflow.com StackOverflow] is a great site for questions.
+
* [http://stackexchange.com/ StackExchange] (by extension, [http://stackoverflow.com StackOverflow]) is a great site for questions.
*[http://lynda.com lynda.com]
+
* [http://lynda.com lynda.com]
*JS Fiddle http://jsfiddle.net/
+
* [http://www.pluralsight.com/ PluralSight.com]
*[http://stackexchange.com/ StackExchange] (by extension, StackOverflow and [http://libraries.stackexchange.com/ the Libraries StackExchange] site).
+
* JS Fiddle http://jsfiddle.net/
 +
* CodePen http://codepen.io/
 +
* [http://css-tricks.com CSS Tricks ]
 +
* [http://openhatch.org/ Open Hatch] - to learn tools you need to participate in open source development and find friendly projects to be a part of
 +
* [http://drupalladder.org/ Drupal Ladder], which teaches you what you need to know to participate in developing Drupal
 +
* [http://rubykoans.com/ Ruby Koans] - learn Ruby by fixing failing tests
 +
* [https://librarycarpentry.org/ Library Carpentry] - Free, open-source lessons for non-techy librarians on coding, data analysis, and related topics. They also give in-person workshops upon request.
 +
* [http://jennriley.com/metadatamap/ Seeing Standards] - Let's be frank, there is a giant pile of metadata standards awaiting any newbie to this field. Jenn Riley's map of these standards, and the accompanying glossary, is an invaluable resource. It may be tempting to try to print the PDF of this visualization, just be aware that it is absolutely gigantic. You will need access to a poster printer to do it justice. Don't let that frighten you, feel free to explore it on your computer, save it, keep it as a reference. This poster will help you, you need it.
 +
 
 +
=====Meetups and User Groups=====
 +
 
 +
* Perl Mongers http://www.pm.org/groups/
 +
* Python Local User Groups http://wiki.python.org/moin/LocalUserGroups
 +
** Look for user groups running an incarnation of the [http://bostonpythonworkshop.com/ Boston Python Workshop], a women-and-their-friends day-and-a-half introduction to Python which assumes no prior knowledge.
 +
* R Users Group Meetups http://r-users-group.meetup.com/
 +
* Drupal Groups http://groups.drupal.org/
 +
* Ruby User Groups http://www.ruby-lang.org/en/community/user-groups/
 +
** Look for groups running an incarnation of [http://workshops.railsbridge.org/ RailsBridge] (like Boston Python Workshop except it came first, and covers Ruby)
 +
* Haskell User Groups http://www.haskell.org/haskellwiki/User_groups
 +
* ColdFusion Meetups http://coldfusion.meetup.com/
  
 
=====Other=====
 
=====Other=====
  
*Resources for lots of languages: [http://pear.ly/8ohL pear.ly/8ohL]
+
* Resources for lots of languages: [http://pear.ly/8ohL pear.ly/8ohL]
 
* [http://catcode.pbworks.com/w/page/49680175/Resources Catcode]
 
* [http://catcode.pbworks.com/w/page/49680175/Resources Catcode]
* Local communities of ruby, python users.
+
* [http://foss4lib.org/ FOSS4lib]
* FOSS4lib http://foss4lib.org/
+
 
* I can already feel the collective rolling of eyes for this, but what about Twitter? It's not a guide or manual, but start following and engaging talented developers and library geeks on Twitter and you'll soon have more help than you know what to do with.  Plus, no Zoia ;)
 
* I can already feel the collective rolling of eyes for this, but what about Twitter? It's not a guide or manual, but start following and engaging talented developers and library geeks on Twitter and you'll soon have more help than you know what to do with.  Plus, no Zoia ;)
*Practice! No matter the learning material, nothing will really sink in unless you apply it in the wild (like a small project).
+
* Practice! No matter the learning material, nothing will really sink in unless you apply it in the wild (like a small project).
 
* It's still useful to learn a little something about configuring a webserver / database / etc.
 
* It's still useful to learn a little something about configuring a webserver / database / etc.
 +
* The [http://connect.ala.org/node/167971 Library Code Year Interest Group], an ALA group (joint between LITA and ALCTS) for librarians who want to learn and apply code
  
 
=====Advice on what to do=====
 
=====Advice on what to do=====

Latest revision as of 17:22, 30 March 2019

One recommended tool/resource for n00bs

These resources/tools were recommended by the Code4Lib community in Nov. 2012, specifically for new coding librarians and library coders. The whole thread of discussion is available at the C4L listserv archive.

Please fill out a mini-survey if this was helpful to you. Thank you!

Tools/Resources

Books or Things to read
Software
  • Vi- because it keeps me (you?) focused.
  • Komodo Edit
  • Notepad++ IMO best open source lightweight editor on Windows
  • AMP (LAMP, WAMP, MAMP) stacks for an easy install of Apache, mySQL + perl/ python / php.
  • A @rdio subscription. :) And a text editor with syntax highlighting.
  • Git (Version Control)
  • Github, Bitbucket and Other Remote Git Services
  • Emmet, http://docs.emmet.io/ (supersedes Zen Coding, http://code.google.com/p/zen-coding/ ) The idea is that it lets you use CSS-like selectors as tags that can be expanded into full HTML snippets.
  • SASS Syntactically Awesome Stylesheets
  • LESS http://lesscss.org/
  • Compass http://compass-style.org/ - extends SASS with reusable patterns
  • BareBones's BBEdit
  • Sublime Text & Zen Coding (recently reborn as Emmet). Saves a lot of keystrokes when writing web content.
  • The best one IMHO is Sublime Text 2. Oh, okay, I can't resist - I'm going to cheat and list a second: everyone needs to stop writing just CSS and complement it with SASS (syntactically awesome stylesheets) & Compass - http://sass-lang.com/. Totally invaluable for any front-end work. It makes CSS fun.
  • VirtualBox to make new VM setup and deployment easier we use Vagrant
  • Version control. My own strong preference is for git (either managed locally or through github.com), but really, just pick a version control solution and use it. If you value your work at all, it should be in version control. Smart use of version control can make finding and fixing problems in code much, much easier - but even fairly naive use of it leaves you with much, much better tools for fixing screw ups than you have without it.
Websites
  • Code4Lib listserv, IRC, journal (duh)
  • Google is more useful than any reference book to find answers to programming problems.
  • StackExchange (by extension, StackOverflow) is a great site for questions.
  • lynda.com
  • PluralSight.com
  • JS Fiddle http://jsfiddle.net/
  • CodePen http://codepen.io/
  • CSS Tricks
  • Open Hatch - to learn tools you need to participate in open source development and find friendly projects to be a part of
  • Drupal Ladder, which teaches you what you need to know to participate in developing Drupal
  • Ruby Koans - learn Ruby by fixing failing tests
  • Library Carpentry - Free, open-source lessons for non-techy librarians on coding, data analysis, and related topics. They also give in-person workshops upon request.
  • Seeing Standards - Let's be frank, there is a giant pile of metadata standards awaiting any newbie to this field. Jenn Riley's map of these standards, and the accompanying glossary, is an invaluable resource. It may be tempting to try to print the PDF of this visualization, just be aware that it is absolutely gigantic. You will need access to a poster printer to do it justice. Don't let that frighten you, feel free to explore it on your computer, save it, keep it as a reference. This poster will help you, you need it.
Meetups and User Groups
Other
  • Resources for lots of languages: pear.ly/8ohL
  • Catcode
  • FOSS4lib
  • I can already feel the collective rolling of eyes for this, but what about Twitter? It's not a guide or manual, but start following and engaging talented developers and library geeks on Twitter and you'll soon have more help than you know what to do with. Plus, no Zoia ;)
  • Practice! No matter the learning material, nothing will really sink in unless you apply it in the wild (like a small project).
  • It's still useful to learn a little something about configuring a webserver / database / etc.
  • The Library Code Year Interest Group, an ALA group (joint between LITA and ALCTS) for librarians who want to learn and apply code
Advice on what to do
  • Building things that help people matters, and for that you need empathy.
  • Reusing people's public dotfiles,my favorite being Mathias Bynens'. Using a mature dotfiles collection can help bootstrap you to use the command line more and start grabbing vital tools from package managers like Homebrew or npm that you might not think of otherwise. I'm still a newbie coder but reusing dotfiles gives me the confidence to tweak things here and there without building a ton from scratch.
  • I'm taking "tool" to mean a piece of hardware. I'd recommend some old laptop with your favorite linux distro less desktop. Why? Well the main thing is that it puts them into a position where they're not learning to be a google copy/paste coder given the lack of the desktop, mouse and distractions like email. They can also learn to setup the server environment on their new dev box and eventually do all sorts of cool stuff.
  • A cheapie online webhosting account - like a $10 a month one - and multiple URLs. Multiple URLs will make them point a URL at a nameserver at least once ideally, and to understand that the two are separate and what you can do with domains and subdomains. The cheapie webhosting account will let them play with installing popular content management systems manually and with one-click installs. The most important thing is to break things and then rebuild them. The worst possible thing would be to build a website, leave it up as their public face or personal website, and be nervous to wreck it so notchange or play with different CMSes (another reason multiple URLs might psychologically be better - they encourage experimentation on one and the person can make the other a static goal oriented publishing area).The more the cheapie hosting account experience I have, the more I know what's cheap and easy to do, and the more I see very specific benefits to adedicated server. It makes me more intentional and able to better assess the value of services vendors provide. That's more web4lib ish, but ultimately if someone experiments enough they have to get comfortable with php. Scripting is the gateway drug.
  • +1 to web-hosting as it gives the ability install one's own software on one's domain (which feels great) *and* easy access to shell. And when web-hosting feels like too much of a barrier to access, sites like jsfiddle where you can immediately start adding *and* sharing code is key. IMHO the initial appeal of Codecademy was that it removed all barriers to getting started. Getting a laptop's localhost set up is too daunting for a first step, I think.