contribute.html


<!DOCTYPE HTML>
<html lang="" >
    <head>
        <meta charset="UTF-8">
        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
        <title>Contribute · Clojurebridge London Workshop</title>
        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
        <meta name="description" content="">
        <meta name="generator" content="GitBook 3.2.3">
        
        
    <link rel="stylesheet" href="gitbook/style.css">

    
                <link rel="stylesheet" href="gitbook/gitbook-plugin-callouts/plugin.css">
                
            
                <link rel="stylesheet" href="gitbook/gitbook-plugin-disqus/plugin.css">
                
            
                <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/css/bootstrap.min.css">
                
            
                <link rel="stylesheet" href="gitbook/gitbook-plugin-sectionx/sectionx.css">
                
            
                <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/css/bootstrap.min.css">
                
            
                <link rel="stylesheet" href="gitbook/gitbook-plugin-simpletabs/tabs.css">
                
            
                <link rel="stylesheet" href="gitbook/gitbook-plugin-toggle-chapters/toggle.css">
                
            
                <link rel="stylesheet" href="gitbook/gitbook-plugin-wide-page/wide.css">
                
            
                <link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
                
            
                <link rel="stylesheet" href="gitbook/gitbook-plugin-search/search.css">
                
            
                <link rel="stylesheet" href="gitbook/gitbook-plugin-fontsettings/website.css">
                
            
        <link rel="stylesheet" href="styles/website.css">
        
    
    <meta name="HandheldFriendly" content="true"/>
    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
    <meta name="apple-mobile-web-app-capable" content="yes">
    <meta name="apple-mobile-web-app-status-bar-style" content="black">
    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="gitbook/images/apple-touch-icon-precomposed-152.png">
    <link rel="shortcut icon" href="gitbook/images/favicon.ico" type="image/x-icon">

    
    <link rel="next" href="fancy-keyboard-keys.html" />
    
    
    <link rel="prev" href="comments.html" />
    

    </head>
    <body>
        
<div class="book">
    <div class="book-summary">
        
            
<div id="book-search-input" role="search">
    <input type="text" placeholder="Type to search" />
</div>

            
                <nav role="navigation">
                

<ul class="summary">
    
    
        <li class="header">Friday Overview</li>
        
        
        <li class="chapter " data-level="1.1" data-path="./">
            
                <a href="./">
            
                    
                    ClojureBridge London
            
                </a>
            

            <ul class="articles">
                
    
        <li class="chapter " data-level="1.1.1" data-path="schedule.html">
            
                <a href="schedule.html">
            
                    
                    Schedule
            
                </a>
            

        </li>
    

            </ul>
            
        </li>
    
        <li class="chapter " data-level="1.2" data-path="introducing-clojure/">
            
                <a href="introducing-clojure/">
            
                    
                    Introducing Clojure
            
                </a>
            

            <ul class="articles">
                
    
        <li class="chapter " data-level="1.2.1" data-path="what-is-functional-programming.html">
            
                <a href="what-is-functional-programming.html">
            
                    
                    What is Functional Programming
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="1.2.2" data-path="introducing-clojure/who-uses-clojure.html">
            
                <a href="introducing-clojure/who-uses-clojure.html">
            
                    
                    Powerful - many uses of Clojure
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="1.2.3" data-path="introducing-clojure/simple-small-syntax.html">
            
                <a href="introducing-clojure/simple-small-syntax.html">
            
                    
                    Simple - Small Syntax
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="1.2.4" data-path="introducing-clojure/coding-in-the-repl.html">
            
                <a href="introducing-clojure/coding-in-the-repl.html">
            
                    
                    Fun - Coding in the REPL
            
                </a>
            

            <ul class="articles">
                
    
        <li class="chapter " data-level="1.2.4.1" data-path="introducing-clojure/rich-terminals.html">
            
                <a href="introducing-clojure/rich-terminals.html">
            
                    
                    Rich terminals
            
                </a>
            

        </li>
    

            </ul>
            
        </li>
    
        <li class="chapter " data-level="1.2.5" data-path="introducing-clojure/clojure-creative-arts.html">
            
                <a href="introducing-clojure/clojure-creative-arts.html">
            
                    
                    Creative Arts
            
                </a>
            

            <ul class="articles">
                
    
        <li class="chapter " data-level="1.2.5.1" data-path="introducing-clojure/generate-html-from-hiccup.html">
            
                <a href="introducing-clojure/generate-html-from-hiccup.html">
            
                    
                    Generate HTML with Hiccup
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="1.2.5.2" data-path="introducing-clojure/generative-graphics.html">
            
                <a href="introducing-clojure/generative-graphics.html">
            
                    
                    Generative Graphics
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="1.2.5.3" data-path="introducing-clojure/data-science-visualisation.html">
            
                <a href="introducing-clojure/data-science-visualisation.html">
            
                    
                    Data Science
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="1.2.5.4" data-path="introducing-clojure/clojure-svg-graphics.html">
            
                <a href="introducing-clojure/clojure-svg-graphics.html">
            
                    
                    SVG Graphics - reagent
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="1.2.5.5" data-path="introducing-clojure/clojure-games.html">
            
                <a href="introducing-clojure/clojure-games.html">
            
                    
                    2D Games
            
                </a>
            

        </li>
    

            </ul>
            
        </li>
    

            </ul>
            
        </li>
    
        <li class="chapter " data-level="1.3" data-path="prepare-for-the-workshop.html">
            
                <a href="prepare-for-the-workshop.html">
            
                    
                    Preparing for the Workshop
            
                </a>
            

            <ul class="articles">
                
    
        <li class="chapter " data-level="1.3.1" data-path="development-tools/">
            
                <a href="development-tools/">
            
                    
                    Development Tools
            
                </a>
            

            <ul class="articles">
                
    
        <li class="chapter " data-level="1.3.1.1" data-path="development-tools/java.html">
            
                <a href="development-tools/java.html">
            
                    
                    Java
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="1.3.1.2" data-path="development-tools/leiningen.html">
            
                <a href="development-tools/leiningen.html">
            
                    
                    Leiningen
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="1.3.1.3" data-path="development-tools/install-guides/">
            
                <a href="development-tools/install-guides/">
            
                    
                    Editor install guides
            
                </a>
            

            <ul class="articles">
                
    
        <li class="chapter " data-level="1.3.1.3.1" data-path="development-tools/install-guides/atom-protorepl.html">
            
                <a href="development-tools/install-guides/atom-protorepl.html">
            
                    
                    Atom.io - ProtoREPL
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="1.3.1.3.2" data-path="development-tools/install-guides/atom-proton.html">
            
                <a href="development-tools/install-guides/atom-proton.html">
            
                    
                    Atom.io - Proton
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="1.3.1.3.3" data-path="development-tools/install-guides/vscode-calva.html">
            
                <a href="development-tools/install-guides/vscode-calva.html">
            
                    
                    VS Code - Calva
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="1.3.1.3.4" data-path="development-tools/install-guides/emacs-spacemacs.html">
            
                <a href="development-tools/install-guides/emacs-spacemacs.html">
            
                    
                    Emacs - Spacemacs
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="1.3.1.3.5" data-path="development-tools/install-guides/intellij-cursive.html">
            
                <a href="development-tools/install-guides/intellij-cursive.html">
            
                    
                    IntelliJ - Cursive
            
                </a>
            

        </li>
    

            </ul>
            
        </li>
    
        <li class="chapter " data-level="1.3.1.4" data-path="development-tools/create-a-project.html">
            
                <a href="development-tools/create-a-project.html">
            
                    
                    Create a project
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="1.3.1.5" data-path="development-tools/editor-guides/">
            
                <a href="development-tools/editor-guides/">
            
                    
                    Editor User Guides
            
                </a>
            

            <ul class="articles">
                
    
        <li class="chapter " data-level="1.3.1.5.1" data-path="development-tools/editor-guides/atom-protorepl.html">
            
                <a href="development-tools/editor-guides/atom-protorepl.html">
            
                    
                    Atom.io - Protorepl
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="1.3.1.5.2" data-path="development-tools/editor-guides/atom-proton.html">
            
                <a href="development-tools/editor-guides/atom-proton.html">
            
                    
                    Atom.io - Proton
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="1.3.1.5.3" data-path="development-tools/editor-guides/emacs-spacemacs.html">
            
                <a href="development-tools/editor-guides/emacs-spacemacs.html">
            
                    
                    Emacs - Spacemacs
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="1.3.1.5.4" data-path="development-tools/editor-guides/vscode-calva.html">
            
                <a href="development-tools/editor-guides/vscode-calva.html">
            
                    
                    VS Code - Calva
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="1.3.1.5.5" data-path="development-tools/editor-guides/intellij-cursive.html">
            
                <a href="development-tools/editor-guides/intellij-cursive.html">
            
                    
                    IntelliJ - Cursive
            
                </a>
            

        </li>
    

            </ul>
            
        </li>
    
        <li class="chapter " data-level="1.3.1.6" data-path="development-tools/example-project.html">
            
                <a href="development-tools/example-project.html">
            
                    
                    Example project
            
                </a>
            

        </li>
    

            </ul>
            
        </li>
    

            </ul>
            
        </li>
    
        <li class="chapter " data-level="1.4" data-path="introducing-clojure/getting-help.html">
            
                <a href="introducing-clojure/getting-help.html">
            
                    
                    Getting Help
            
                </a>
            

        </li>
    

        <li class="header">Saturday</li>
        
        
        <li class="chapter " data-level="2.1" data-path="clojurebridge-workshop.html">
            
                <a href="clojurebridge-workshop.html">
            
                    
                    Overview
            
                </a>
            

        </li>
    

        <li class="header">Colours and Shapes</li>
        
        
        <li class="chapter " data-level="3.1" data-path="colours-and-shapes/">
            
                <a href="colours-and-shapes/">
            
                    
                    Colours & Shapes
            
                </a>
            

        </li>
    

        <li class="header">Clojure Essentials</li>
        
        
        <li class="chapter " data-level="4.1" data-path="clojure-essentials.html">
            
                <a href="clojure-essentials.html">
            
                    
                    Clojure Essentials
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="4.2" data-path="simple-values/">
            
                <a href="simple-values/">
            
                    
                    Level 1- Simple Values
            
                </a>
            

            <ul class="articles">
                
    
        <li class="chapter " data-level="4.2.1" data-path="simple-values/numbers.html">
            
                <a href="simple-values/numbers.html">
            
                    
                    Numbers
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="4.2.2" data-path="simple-values/arithmetic.html">
            
                <a href="simple-values/arithmetic.html">
            
                    
                    Arithmetic
            
                </a>
            

            <ul class="articles">
                
    
        <li class="chapter " data-level="4.2.2.1" data-path="simple-values/exercise-age-of-languages.html">
            
                <a href="simple-values/exercise-age-of-languages.html">
            
                    
                    Exercise: Age of Languages
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="4.2.2.2" data-path="simple-values/exercise-time-to-numbers.html">
            
                <a href="simple-values/exercise-time-to-numbers.html">
            
                    
                    Exercise: Time to Numbers
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="4.2.2.3" data-path="simple-values/prefix-notation.html">
            
                <a href="simple-values/prefix-notation.html">
            
                    
                    Theory: Prefix Notation
            
                </a>
            

        </li>
    

            </ul>
            
        </li>
    
        <li class="chapter " data-level="4.2.3" data-path="simple-values/strings.html">
            
                <a href="simple-values/strings.html">
            
                    
                    Strings
            
                </a>
            

            <ul class="articles">
                
    
        <li class="chapter " data-level="4.2.3.1" data-path="simple-values/exercise-string-of-colours.html">
            
                <a href="simple-values/exercise-string-of-colours.html">
            
                    
                    Exercise: String of Colours
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="4.2.3.2" data-path="simple-values/exercise-string-spell-checking.html">
            
                <a href="simple-values/exercise-string-spell-checking.html">
            
                    
                    Exercise: Spell Checking
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="4.2.3.3" data-path="simple-values/exercise-string-palindrome.html">
            
                <a href="simple-values/exercise-string-palindrome.html">
            
                    
                    Exercise: Palindromes
            
                </a>
            

        </li>
    

            </ul>
            
        </li>
    

            </ul>
            
        </li>
    
        <li class="chapter " data-level="4.3" data-path="assignment/">
            
                <a href="assignment/">
            
                    
                    Level 2 - Assignment
            
                </a>
            

            <ul class="articles">
                
    
        <li class="chapter " data-level="4.3.1" data-path="assignment/let-local-assignment.html">
            
                <a href="assignment/let-local-assignment.html">
            
                    
                    let - Local assignment
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="4.3.2" data-path="assignment/def-shared-assignment.html">
            
                <a href="assignment/def-shared-assignment.html">
            
                    
                    def - shared assignment
            
                </a>
            

        </li>
    

            </ul>
            
        </li>
    
        <li class="chapter " data-level="4.4" data-path="collections/">
            
                <a href="collections/">
            
                    
                    Level 3- Collections
            
                </a>
            

            <ul class="articles">
                
    
        <li class="chapter " data-level="4.4.1" data-path="collections/vectors.html">
            
                <a href="collections/vectors.html">
            
                    
                    Vectors
            
                </a>
            

            <ul class="articles">
                
    
        <li class="chapter " data-level="4.4.1.1" data-path="collections/reading-values-from-vectors-by-index.html">
            
                <a href="collections/reading-values-from-vectors-by-index.html">
            
                    
                    Reading values by index
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="4.4.1.2" data-path="collections/vector-excercise-weather-forcast.html">
            
                <a href="collections/vector-excercise-weather-forcast.html">
            
                    
                    Exercise: Weather Forecast
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="4.4.1.3" data-path="collections/reading-values-from-vectors-sequentially.html">
            
                <a href="collections/reading-values-from-vectors-sequentially.html">
            
                    
                    Reading values sequentially
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="4.4.1.4" data-path="collections/exercise-average-age-of-languages.html">
            
                <a href="collections/exercise-average-age-of-languages.html">
            
                    
                    Exercise: Average age of languages
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="4.4.1.5" data-path="collections/adding-values-to-vectors.html">
            
                <a href="collections/adding-values-to-vectors.html">
            
                    
                    Adding values to vectors
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="4.4.1.6" data-path="collections/comparing-vectors.html">
            
                <a href="collections/comparing-vectors.html">
            
                    
                    Comparing Vectors
            
                </a>
            

        </li>
    

            </ul>
            
        </li>
    
        <li class="chapter " data-level="4.4.2" data-path="collections/maps.html">
            
                <a href="collections/maps.html">
            
                    
                    Maps
            
                </a>
            

            <ul class="articles">
                
    
        <li class="chapter " data-level="4.4.2.1" data-path="simple-values/keywords.html">
            
                <a href="simple-values/keywords.html">
            
                    
                    Keywords
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="4.4.2.2" data-path="collections/map-syntax.html">
            
                <a href="collections/map-syntax.html">
            
                    
                    Map Syntax
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="4.4.2.3" data-path="collections/map-creation.html">
            
                <a href="collections/map-creation.html">
            
                    
                    Map Creation
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="4.4.2.4" data-path="collections/map-update.html">
            
                <a href="collections/map-update.html">
            
                    
                    Map Update
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="4.4.2.5" data-path="collections/map-extraction-with-get.html">
            
                <a href="collections/map-extraction-with-get.html">
            
                    
                    Map Extraction with get
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="4.4.2.6" data-path="collections/map-extraction-keys-vals.html">
            
                <a href="collections/map-extraction-keys-vals.html">
            
                    
                    Map Extraction with keys & vals
            
                </a>
            

        </li>
    

            </ul>
            
        </li>
    
        <li class="chapter " data-level="4.4.3" data-path="collections/collection-of-collections.html">
            
                <a href="collections/collection-of-collections.html">
            
                    
                    Collection of Collections
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="4.4.4" data-path="collections/exercise-model-people.html">
            
                <a href="collections/exercise-model-people.html">
            
                    
                    Exercise: Model People
            
                </a>
            

        </li>
    

            </ul>
            
        </li>
    
        <li class="chapter " data-level="4.5" data-path="functions/">
            
                <a href="functions/">
            
                    
                    Level 4 - Functions
            
                </a>
            

            <ul class="articles">
                
    
        <li class="chapter " data-level="4.5.1" data-path="functions/defining-functions.html">
            
                <a href="functions/defining-functions.html">
            
                    
                    Defining Functions
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="4.5.2" data-path="functions/local-assignment-with-let.html">
            
                <a href="functions/local-assignment-with-let.html">
            
                    
                    Local Assignment with let
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="4.5.3" data-path="functions/name-smash.html">
            
                <a href="functions/name-smash.html">
            
                    
                    Exercise: Name Smash
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="4.5.4" data-path="functions/functions-as-arguments.html">
            
                <a href="functions/functions-as-arguments.html">
            
                    
                    Higher Order Functions
            
                </a>
            

            <ul class="articles">
                
    
        <li class="chapter " data-level="4.5.4.1" data-path="functions/map-function.html">
            
                <a href="functions/map-function.html">
            
                    
                    map function
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="4.5.4.2" data-path="functions/reduce-function.html">
            
                <a href="functions/reduce-function.html">
            
                    
                    reduce function
            
                </a>
            

        </li>
    

            </ul>
            
        </li>
    
        <li class="chapter " data-level="4.5.5" data-path="functions/exercise-find-the-average.html">
            
                <a href="functions/exercise-find-the-average.html">
            
                    
                    Exercise: Find the average
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="4.5.6" data-path="functions/map-reduce-sandwich.html">
            
                <a href="functions/map-reduce-sandwich.html">
            
                    
                    Exercise: Map Reduce Sandwich
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="4.5.7" data-path="functions/exercise-are-we-there-yet.html">
            
                <a href="functions/exercise-are-we-there-yet.html">
            
                    
                    Exercise: are we there yet?
            
                </a>
            

        </li>
    

            </ul>
            
        </li>
    
        <li class="chapter " data-level="4.6" data-path="flow-control-logic/">
            
                <a href="flow-control-logic/">
            
                    
                    Level 5 - Flow Control & Logic
            
                </a>
            

            <ul class="articles">
                
    
        <li class="chapter " data-level="4.6.1" data-path="simple-values/boolean.html">
            
                <a href="simple-values/boolean.html">
            
                    
                    Boolean values
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="4.6.2" data-path="flow-control-logic/if.html">
            
                <a href="flow-control-logic/if.html">
            
                    
                    if
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="4.6.3" data-path="flow-control-logic/truthiness.html">
            
                <a href="flow-control-logic/truthiness.html">
            
                    
                    truthiness
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="4.6.4" data-path="flow-control-logic/exercise-positions.html">
            
                <a href="flow-control-logic/exercise-positions.html">
            
                    
                    Exercise: positions
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="4.6.5" data-path="flow-control-logic/exercise-positions-continued.html">
            
                <a href="flow-control-logic/exercise-positions-continued.html">
            
                    
                    Exercise: positions continued
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="4.6.6" data-path="flow-control-logic/cond.html">
            
                <a href="flow-control-logic/cond.html">
            
                    
                    cond
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="4.6.7" data-path="flow-control-logic/exercise-temperature-conversion.html">
            
                <a href="flow-control-logic/exercise-temperature-conversion.html">
            
                    
                    Exercise: Temperature conversion
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="4.6.8" data-path="flow-control-logic/boolean-logic.html">
            
                <a href="flow-control-logic/boolean-logic.html">
            
                    
                    Theory: Boolean Logic
            
                </a>
            

        </li>
    

            </ul>
            
        </li>
    
        <li class="chapter " data-level="4.7" data-path="iteration/">
            
                <a href="iteration/">
            
                    
                    Level 6 - Iteration
            
                </a>
            

            <ul class="articles">
                
    
        <li class="chapter " data-level="4.7.1" data-path="iteration/exercise-combination-lock.html">
            
                <a href="iteration/exercise-combination-lock.html">
            
                    
                    Exercise: Combination Lock
            
                </a>
            

        </li>
    

            </ul>
            
        </li>
    

        <li class="header">More Challenges & Projects</li>
        
        
        <li class="chapter " data-level="5.1" data-path="challenges-projects.html">
            
                <a href="challenges-projects.html">
            
                    
                    More Challenges & Projects
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="5.2" data-path="kata-challenges/">
            
                <a href="kata-challenges/">
            
                    
                    Kata challenges
            
                </a>
            

            <ul class="articles">
                
    
        <li class="chapter " data-level="5.2.1" data-path="kata-challenges/recent-song-playlist.html">
            
                <a href="kata-challenges/recent-song-playlist.html">
            
                    
                    Recent Song Playlist
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="5.2.2" data-path="kata-challenges/testing-code.html">
            
                <a href="kata-challenges/testing-code.html">
            
                    
                    Testing code
            
                </a>
            

            <ul class="articles">
                
    
        <li class="chapter " data-level="5.2.2.1" data-path="kata-challenges/clojure-test.html">
            
                <a href="kata-challenges/clojure-test.html">
            
                    
                    Clojure Test
            
                </a>
            

        </li>
    

            </ul>
            
        </li>
    

            </ul>
            
        </li>
    
        <li class="chapter " data-level="5.3" data-path="additional-projects/">
            
                <a href="additional-projects/">
            
                    
                    Additional Projects
            
                </a>
            

            <ul class="articles">
                
    
        <li class="chapter " data-level="5.3.1" >
            
                <a target="_blank" href="https://clojurebridgelondon.github.io/community-docs/docs/curriculum/most-common-word">
            
                    
                    Most Common Word
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="5.3.2" data-path="additional-projects/celebrity-name-smash.html">
            
                <a href="additional-projects/celebrity-name-smash.html">
            
                    
                    Celebrity Name Smash
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="5.3.3" data-path="additional-projects/clacks-messages.html">
            
                <a href="additional-projects/clacks-messages.html">
            
                    
                    Clack Messages
            
                </a>
            

        </li>
    

            </ul>
            
        </li>
    

        <li class="header">Responsive Websites</li>
        
        
        <li class="chapter " data-level="6.1" data-path="additional-projects/clojurebridge-website/">
            
                <a href="additional-projects/clojurebridge-website/">
            
                    
                    ClojureBridge website
            
                </a>
            

            <ul class="articles">
                
    
        <li class="chapter " data-level="6.1.1" data-path="additional-projects/clojurebridge-website/create-project.html">
            
                <a href="additional-projects/clojurebridge-website/create-project.html">
            
                    
                    Create project
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="6.1.2" data-path="additional-projects/clojurebridge-website/add-bluma-css.html">
            
                <a href="additional-projects/clojurebridge-website/add-bluma-css.html">
            
                    
                    Add Bulma CSS
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="6.1.3" data-path="additional-projects/clojurebridge-website/run-the-project.html">
            
                <a href="additional-projects/clojurebridge-website/run-the-project.html">
            
                    
                    Run the project
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="6.1.4" data-path="additional-projects/clojurebridge-website/live-reloading.html">
            
                <a href="additional-projects/clojurebridge-website/live-reloading.html">
            
                    
                    Live reloading
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="6.1.5" data-path="additional-projects/clojurebridge-website/hiccup-for-html.html">
            
                <a href="additional-projects/clojurebridge-website/hiccup-for-html.html">
            
                    
                    Hiccup for HTML
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="6.1.6" data-path="additional-projects/clojurebridge-website/mount-lifecycle-management.html">
            
                <a href="additional-projects/clojurebridge-website/mount-lifecycle-management.html">
            
                    
                    mount lifecycle management
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="6.1.7" data-path="additional-projects/clojurebridge-website/organising-the-code.html">
            
                <a href="additional-projects/clojurebridge-website/organising-the-code.html">
            
                    
                    Organising the code
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="6.1.8" data-path="additional-projects/clojurebridge-website/add-welcome-message.html">
            
                <a href="additional-projects/clojurebridge-website/add-welcome-message.html">
            
                    
                    Add welcome message
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="6.1.9" data-path="additional-projects/clojurebridge-website/add-welcome-section.html">
            
                <a href="additional-projects/clojurebridge-website/add-welcome-section.html">
            
                    
                    Add welcome section
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="6.1.10" data-path="additional-projects/clojurebridge-website/responsive-design.html">
            
                <a href="additional-projects/clojurebridge-website/responsive-design.html">
            
                    
                    Responsive design
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="6.1.11" data-path="additional-projects/clojurebridge-website/app-state-section.html">
            
                <a href="additional-projects/clojurebridge-website/app-state-section.html">
            
                    
                    App State section
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="6.1.12" data-path="additional-projects/clojurebridge-website/github-pages-deploy.html">
            
                <a href="additional-projects/clojurebridge-website/github-pages-deploy.html">
            
                    
                    GitHub pages deploy
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="6.1.13" data-path="additional-projects/clojurebridge-website/deploy-build.html">
            
                <a href="additional-projects/clojurebridge-website/deploy-build.html">
            
                    
                    Deploy build
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="6.1.14" data-path="additional-projects/clojurebridge-website/add-content-namespace.html">
            
                <a href="additional-projects/clojurebridge-website/add-content-namespace.html">
            
                    
                    Add Content namespace
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="6.1.15" data-path="additional-projects/clojurebridge-website/add-more-sections.html">
            
                <a href="additional-projects/clojurebridge-website/add-more-sections.html">
            
                    
                    Add more sections
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="6.1.16" data-path="additional-projects/clojurebridge-website/add-navigation.html">
            
                <a href="additional-projects/clojurebridge-website/add-navigation.html">
            
                    
                    Navigation bar
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="6.1.17" data-path="additional-projects/clojurebridge-website/interacting/">
            
                <a href="additional-projects/clojurebridge-website/interacting/">
            
                    
                    Interacting
            
                </a>
            

        </li>
    

            </ul>
            
        </li>
    
        <li class="chapter " data-level="6.2" data-path="additional-projects/clojurebridge-london-website.html">
            
                <a href="additional-projects/clojurebridge-london-website.html">
            
                    
                    Bootstrap website
            
                </a>
            

        </li>
    

        <li class="header">Learning Resources</li>
        
        
        <li class="chapter " data-level="7.1" data-path="learning-resources.html">
            
                <a href="learning-resources.html">
            
                    
                    Learning resources
            
                </a>
            

        </li>
    

        <li class="header">Miscellaneous content</li>
        
        
        <li class="chapter " data-level="8.1" >
            
                <a target="_blank" href="https://clojurebridgelondon.github.io/community-docs/">
            
                    
                    Reference
            
                </a>
            

            <ul class="articles">
                
    
        <li class="chapter " data-level="8.1.1" data-path="introducing-clojure/clojure-strengths.html">
            
                <a href="introducing-clojure/clojure-strengths.html">
            
                    
                    Clojure strengths
            
                </a>
            

            <ul class="articles">
                
    
        <li class="chapter " data-level="8.1.1.1" data-path="introducing-clojure/clojure-concurrency-parallelism.html">
            
                <a href="introducing-clojure/clojure-concurrency-parallelism.html">
            
                    
                    Concurrency & Parallelism
            
                </a>
            

        </li>
    

            </ul>
            
        </li>
    
        <li class="chapter " data-level="8.1.2" data-path="functions/pure-functions.html">
            
                <a href="functions/pure-functions.html">
            
                    
                    Theory: Simplicity with Pure Functions
            
                </a>
            

            <ul class="articles">
                
    
        <li class="chapter " data-level="8.1.2.1" data-path="functions/pure-function-examples.html">
            
                <a href="functions/pure-function-examples.html">
            
                    
                    Pure function examples
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="8.1.2.2" data-path="functions/impure-function-examples.html">
            
                <a href="functions/impure-function-examples.html">
            
                    
                    Impure function examples
            
                </a>
            

        </li>
    

            </ul>
            
        </li>
    
        <li class="chapter " data-level="8.1.3" data-path="functions/anonymous-functions.html">
            
                <a href="functions/anonymous-functions.html">
            
                    
                    Anonymous Functions
            
                </a>
            

            <ul class="articles">
                
    
        <li class="chapter " data-level="8.1.3.1" data-path="functions/named-or-anonymous-functions.html">
            
                <a href="functions/named-or-anonymous-functions.html">
            
                    
                    Named or anonymous functions
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="8.1.3.2" data-path="functions/calling-anonymous-functions.html">
            
                <a href="functions/calling-anonymous-functions.html">
            
                    
                    Calling anonymous functions
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="8.1.3.3" data-path="functions/arguments-to-functions.html">
            
                <a href="functions/arguments-to-functions.html">
            
                    
                    Arguments to functions
            
                </a>
            

        </li>
    

            </ul>
            
        </li>
    
        <li class="chapter " data-level="8.1.4" data-path="functions/predicate-functions.html">
            
                <a href="functions/predicate-functions.html">
            
                    
                    Predicate Functions
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="8.1.5" data-path="introducing-clojure/generating-wallpaper.html">
            
                <a href="introducing-clojure/generating-wallpaper.html">
            
                    
                    Generating Wallpaper
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="8.1.6" data-path="recap-what-does-clojure-look-like.html">
            
                <a href="recap-what-does-clojure-look-like.html">
            
                    
                    Recap: What does Clojure look like
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="8.1.7" data-path="comments.html">
            
                <a href="comments.html">
            
                    
                    Comments
            
                </a>
            

        </li>
    

            </ul>
            
        </li>
    
        <li class="chapter active" data-level="8.2" data-path="contribute.html">
            
                <a href="contribute.html">
            
                    
                    Contribute
            
                </a>
            

            <ul class="articles">
                
    
        <li class="chapter " data-level="8.2.1" data-path="fancy-keyboard-keys.html">
            
                <a href="fancy-keyboard-keys.html">
            
                    
                    Fancy Keyboard Keys
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="8.2.2" data-path="klipse/">
            
                <a href="klipse/">
            
                    
                    Klipse
            
                </a>
            

            <ul class="articles">
                
    
        <li class="chapter " data-level="8.2.2.1" data-path="klipse/scope.html">
            
                <a href="klipse/scope.html">
            
                    
                    Klipse Scope
            
                </a>
            

        </li>
    
        <li class="chapter " data-level="8.2.2.2" data-path="klipse/issues.html">
            
                <a href="klipse/issues.html">
            
                    
                    Klipse issues
            
                </a>
            

        </li>
    

            </ul>
            
        </li>
    

            </ul>
            
        </li>
    

    <li class="divider"></li>

    <li>
        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
            Published with GitBook
        </a>
    </li>
</ul>


                </nav>
            
        
    </div>

    <div class="book-body">
        
            <div class="body-inner">
                
                    
<div class="book-header" role="navigation">
    

    <!-- Title -->
    <h1>
        <i class="fa fa-circle-o-notch fa-spin"></i>
        <a href="." >Contribute</a>
    </h1>
</div>


                    <div class="page-wrapper" tabindex="-1" role="main">
                        <div class="page-inner">
                            
<div id="book-search-results">
    <div class="search-noresults">
    
                                <section class="normal markdown-section">
                                
                                <h1 id="contributing-to-clojurebridge-workshop">Contributing to ClojureBridge Workshop</h1>
<p>Thank you for considering contributing to the content of this workshop.</p>
<p>Any of the following aspects are valuable contributions</p>
<ul>
<li>Code examples</li>
<li>Explanations of Clojure &amp; Functional Programming concepts</li>
<li>Code challenges (exercises for students)</li>
</ul>
<p>Feedback on: </p>
<ul>
<li>how well any concepts are explained</li>
<li>how simple the code examples are to follow</li>
<li>if code challenges are clear, to easy or to challenging</li>
</ul>
<p>Please ask about contributing at the <strong>#clojurebridge-london</strong> channel on the <a href="https://clojurians.slack.com/" target="_blank">Clojurians Slack community</a>.  </p>
<blockquote>
<p>Use the <a href="http://clojurians.net/" target="_blank">Clojurians.net slackbot</a> for an invite if you do not have a login account for the Clojurians Slack community.</p>
</blockquote>
<h2 id="how-to-contribute">How to Contribute</h2>
<p>You can either add or edit content directly on the <a href="https://github.com/ClojureBridgeLondon/workshop-content-gitbook.git" target="_blank">ClojureBridge Workshop Github repository</a> or fork that repository and make changes with your favourite editor and submit a pull request.</p>
<p>All content is in <a href="">markdown</a> files, ending with a file extension of <code>.md</code>.</p>
<p>All content is in English with UK spelling, except in some code snippets that use Americanised words (eg. color).</p>
<h2 id="creating-a-local-environment">Creating a local environment</h2>
<p>The Workshop uses Gitbook to create the website content (html, css, javascript) from the markdown pages.  </p>
<p>You can run your own Gitbook server to see what your changes look like before making a commit.</p>
<h3 id="install-nodejs">Install Node.js</h3>
<p>Gitbook requires <a href="https://nodejs.org/" target="_blank">Node.js</a> and recommends version 6.11.x or greater</p>
<p>The <a href="https://nodejs.org/" target="_blank">Node.js website </a> has installation instructions.  To test you have nodejs working, run the command <code>node -v</code></p>
<h3 id="install-gitbook">Install Gitbook</h3>
<p>Install Gitbook npm package globally (where-ever nodejs itself is installed) using the command</p>
<pre><code class="lang-sh">npm install gitbook-cli -g
</code></pre>
<blockquote>
<p>If the above fails because nodejs is installed in a protected area of your filespace, you will need to install gitbook as administrator using the following command instead <code>sudo npm install gitbook-cli -g</code></p>
</blockquote>
<h3 id="clone-the-workshop-content">Clone the Workshop content</h3>
<p>Use git to download a local copy of the workshop content to your local machine.  For example:</p>
<pre><code class="lang-sh">git <span class="hljs-built_in">clone</span> https://github.com/ClojureBridgeLondon/workshop-content-gitbook.git
</code></pre>
<h3 id="install-gitbook-plugins">Install Gitbook plugins</h3>
<p>Once downloaded, change into the <code>workshop-content-gitbook</code> directory and run the following command to install the supporting plugins for Gitbook</p>
<pre><code class="lang-sh">gitbook install
</code></pre>
<p>Do not run <code>gitbook install</code> as administrator, only your normal user account.  These plugins are installed locally in a folder called <code>node-modules</code> inside the <code>workshop-content-gitbook</code> directory.</p>
<div class="panel panel-warning"><div class="panel-heading"><h3 class="panel-title" id="do-not-run-gitbook-init"><i class="fa fa-exclamation-triangle"></i> Do not run gitbook init</h3></div><div class="panel-body"><p>Please do not run gitbook init inside the <code>workshop-content-gitbook</code> directory or it will updated the navigation and add a second readme.md file.</p></div></div>
<h3 id="running-gitbook-locally">Running Gitbook locally</h3>
<p>Gitbook will run a local webserver on port <code>:4000</code> using the command:</p>
<pre><code class="lang-sh">gitbook serve
</code></pre>
<p>View the website using <a href="http://localhost:4000" target="_blank">http://localhost:4000</a></p>
<h2 id="making-changes">Making changes</h2>
<p>Edit or create new files and once you save changes the website will automatically update.</p>
<h3 id="changing-the-navigation">Changing the Navigation</h3>
<p>The navigation is defined in the file <code>SUMMARY.md</code>.</p>
<p>Each line in this file creates a link in the left hand side navigation of the Gitbook website.  The syntax is <code>[Link name](/path/to/file.md)</code>.</p>
<p>Nested pages of the navigation are defined by inserting 4 space characters at the start of a line.  There can be several levels of nesting.</p>
<p>A style guide for the navigation is to create a directory and index.md file for each section and contain all the markdown files under that section in that directory.</p>
<h2 id="contributing-changes">Contributing changes</h2>
<p>Please create a pull request on the <a href="https://github.com/ClojureBridgeLondon/workshop-content-gitbook.git" target="_blank">ClojureBridge Workshop Github repository</a>.</p>
<p>Thank you.
<a href="https://github.com/jr0cket" target="_blank">@jr0cket</a></p>
 <link rel="stylesheet" type="text/css" href="https://storage.googleapis.com/app.klipse.tech/css/codemirror.css"> <script>     window.klipse_settings = {         selector: ".language-klipse, .lang-eval-clojure",         selector_eval_js: ".lang-eval-js",         selector_eval_python_client: ".lang-eval-python",         selector_eval_php: ".lang-eval-php",         selector_eval_scheme: ".lang-eval-scheme",         selector_eval_ruby: ".lang-eval-ruby",         selector_reagent: ".lang-reagent",        selector_google_charts: ".lang-google-chart",        selector_es2017: ".lang-eval-es2017",        selector_jsx: ".lang-eval-jsx",        selector_transpile_jsx: ".lang-transpile-jsx",        selector_render_jsx: ".lang-render-jsx",        selector_react: ".lang-react",        selector_eval_markdown: ".lang-render-markdown",        selector_eval_lambdaway: ".lang-render-lambdaway",        selector_eval_cpp: ".lang-eval-cpp",        selector_eval_html: ".lang-render-html",        selector_sql: ".lang-eval-sql",        selector_brainfuck: "lang-eval-brainfuck",        selector_js: ".lang-transpile-cljs"    }; </script> <script src="https://storage.googleapis.com/app.klipse.tech/plugin/js/klipse_plugin.js"></script>
                                
                                </section>
                            
    </div>
    <div class="search-results">
        <div class="has-results">
            
            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
            <ul class="search-results-list"></ul>
            
        </div>
        <div class="no-results">
            
            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
            
        </div>
    </div>
</div>

                        </div>
                    </div>
                
            </div>

            
                <a href="comments.html" class="navigation navigation-prev " aria-label="Previous page: Comments">
                    <i class="fa fa-angle-left"></i>
                </a>
                
                
                <a href="fancy-keyboard-keys.html" class="navigation navigation-next " aria-label="Next page: Fancy Keyboard Keys">
                    <i class="fa fa-angle-right"></i>
                </a>
                
            
    </div>

    <script>
        var gitbook = gitbook || [];
        gitbook.push(function() {
            gitbook.page.hasChanged({"page":{"title":"Contribute","level":"8.2","depth":1,"next":{"title":"Fancy Keyboard Keys","level":"8.2.1","depth":2,"path":"fancy-keyboard-keys.md","ref":"fancy-keyboard-keys.md","articles":[]},"previous":{"title":"Comments","level":"8.1.7","depth":2,"path":"comments.md","ref":"comments.md","articles":[]},"dir":"ltr"},"config":{"plugins":["callouts","codeblock-disable-glossary","disqus","ga","gist","klipse","sectionx","simpletabs","toggle-chapters","toolbar","youtube","wide-page"],"styles":{"website":"styles/website.css","ebook":"styles/ebook.css","pdf":"styles/pdf.css","mobi":"styles/mobi.css","epub":"styles/epub.css"},"pluginsConfig":{"disqus":{"useIdentifier":false,"shortName":"clojurebridgeln"},"callouts":{"showTypeInHeader":false,"star":{"alert":"warning","picto":"fa-star"}},"gist":{},"youtube":{},"search":{},"wide-page":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"simpletabs":{},"codeblock-disable-glossary":{},"fontsettings":{"theme":"white","family":"sans","size":2},"sectionx":{"tag":"b"},"highlight":{},"ga":{"configuration":"auto","token":"UA-28030709-10"},"klipse":{"myConfigKey":"it's the default value"},"toolbar":{"buttons":[{"label":"Clojurians Slack community","icon":"fa fa-comments-o","url":"https://clojurians.slack.com/messages/clojurebridge-london"},{"label":"GitHub","icon":"fa fa-github","url":"https://github.com/ClojureBridgeLondon/workshop-content-gitbook"},{"label":"Search page title on StackOverflow","icon":"fa fa-stack-overflow","url":"http://stackoverflow.com/search?q={{title}}"}]},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false},"toggle-chapters":{}},"theme":"default","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"introduction.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Clojurebridge London Workshop","gitbook":">=3.0.0","description":"Introducing Clojure development and the essence of functional programming"},"file":{"path":"contribute.md","mtime":"2020-02-20T00:00:21.668Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2020-03-04T11:53:11.406Z"},"basePath":".","book":{"language":""}});
        });
    </script>
</div>

        
    <script src="gitbook/gitbook.js"></script>
    <script src="gitbook/theme.js"></script>
    
        
        <script src="gitbook/gitbook-plugin-codeblock-disable-glossary/disable-glossary.js"></script>
        
    
        <script src="https://cdnjs.cloudflare.com/ajax/libs/URI.js/1.16.1/URI.min.js"></script>
        
    
        <script src="gitbook/gitbook-plugin-disqus/plugin.js"></script>
        
    
        <script src="gitbook/gitbook-plugin-ga/plugin.js"></script>
        
    
        <script src="https://cdnjs.cloudflare.com/ajax/libs/gist-embed/2.4/gist-embed.min.js"></script>
        
    
        <script src="gitbook/gitbook-plugin-gist/plugin.js"></script>
        
    
        <script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/js/bootstrap.min.js"></script>
        
    
        <script src="gitbook/gitbook-plugin-sectionx/sectionx.js"></script>
        
    
        <script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/js/bootstrap.min.js"></script>
        
    
        <script src="gitbook/gitbook-plugin-simpletabs/tabs.js"></script>
        
    
        <script src="gitbook/gitbook-plugin-toggle-chapters/toggle.js"></script>
        
    
        <script src="gitbook/gitbook-plugin-toolbar/buttons.js"></script>
        
    
        <script src="gitbook/gitbook-plugin-search/search-engine.js"></script>
        
    
        <script src="gitbook/gitbook-plugin-search/search.js"></script>
        
    
        <script src="gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
        
    
        <script src="gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
        
    
        <script src="gitbook/gitbook-plugin-sharing/buttons.js"></script>
        
    
        <script src="gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
        
    
    </body>
</html>