Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Newer
Older
100644 111 lines (88 sloc) 4.28 kB
23cb6e4 @bryanlarsen Round tripped the patches. Fixed up the errors caused by the round
bryanlarsen authored
1 intro
eab7343 @bryanlarsen Up to part 1.
bryanlarsen authored
2
3 From: Bryan Larsen <bryan@larsen.st>
4
e68de30 Bunch of changes -- added sidebar support, fixed up git instructions,…
Bryan Larsen authored
5 OUTPUT_FILE: agility.markdown
6
d07f6cc @bryanlarsen fixup markdown errors, remove "Part X" from titles, add gitorial intro.
bryanlarsen authored
7 The Agility Tutorial - A simple story manager
b65bd35 @bryanlarsen Oops, I created the gitorial from an older copy of the tutorial. Patch
bryanlarsen authored
8 {: .document-title}
9
10 Contents
eab7343 @bryanlarsen Up to part 1.
bryanlarsen authored
11 {: .contents-heading}
12
13 - contents
14 {:toc}
15
16 # Introduction
17
08732dd @bryanlarsen first pass at Hobo 1.3 support. Selenium & Translation chapters are
bryanlarsen authored
18 In this tutorial we'll be creating a simple "Agile Development"
19 application -- _Agility_. The application tracks projects which
20 consist of a number of user stories. Stories have a status
21 (e.g. accepted, under development...) as well as a number of
22 associated tasks. Tasks can be assigned to users, and each user can
23 see a heads-up of all the tasks they've been assigned to on their home
24 page.
25
26 This is a bit of an in-at-the-deep-end tutorial -- we build the app
27 the way you would assuming you had already got the hang of the way
28 Hobo works. In the later stages new concepts start coming thick and
29 fast. The goal here is to show you what's possible, and give you a
30 flavour of Hobo-style application development, rather than to provide
31 detailed background on how everything works. Don't worry about it,
32 it's fun! If you'd rather take things a bit slower, you might prefer
33 the Hobo book (insert link here).
eab7343 @bryanlarsen Up to part 1.
bryanlarsen authored
34
35
d07f6cc @bryanlarsen fixup markdown errors, remove "Part X" from titles, add gitorial intro.
bryanlarsen authored
36 # Getting Started
eab7343 @bryanlarsen Up to part 1.
bryanlarsen authored
37
38
39 ## Introduction to Hobo
40
08732dd @bryanlarsen first pass at Hobo 1.3 support. Selenium & Translation chapters are
bryanlarsen authored
41 Hobo is a bunch of extensions to Ruby on Rails that are designed to
42 make developing any kind of web application a good deal faster and
43 more fun. This tutorial is designed to show off Hobo's ability to get
44 quite sophisticated applications up and running extremely quickly.
eab7343 @bryanlarsen Up to part 1.
bryanlarsen authored
45
08732dd @bryanlarsen first pass at Hobo 1.3 support. Selenium & Translation chapters are
bryanlarsen authored
46 While Hobo is very well suited to this kind of
47 throw-it-together-in-an-afternoon application, it is equally useful
48 for longer term projects, where the end result needs to be very
49 meticulously crafted to the needs of its users. Hopefully the tutorial
50 will give you an idea of how to take your Hobo/Rails application much
51 further.
eab7343 @bryanlarsen Up to part 1.
bryanlarsen authored
52
53 For more info on Hobo please see [hobocentral.net](http://hobocentral.net)
54
55 ## This is a gitorial
56
e68de30 Bunch of changes -- added sidebar support, fixed up git instructions,…
Bryan Larsen authored
57 This is a 'gitorial', a tutorial made with [git](http://git-scm.org).
58 However, we highly recommend that you treat this as you would any
59 other tutorial. The more that you put into the tutorial, the more you
60 will get out of it. If you wish to use 'git' to follow along, see the
61 [sidebar](gitorial). Using git will allow you to skip ahead
62 in the tutorial and to use git to double check your code for errors.
63 We do not recommend learning git and Hobo simultaneously, though.
64
65 [sidebar: using git with the tutorial](gitorial)
66
67 ### How code is displayed in this tutorial
17ce587 @bryanlarsen Update intro & README
bryanlarsen authored
68
69 Code changes in this gitorial are displayed in a modified *patch*
70 format. When you see one of these, they indicate how you should
71 modify the code in your version of this project. Lines that have a
72 "+" in the left hand column and are coloured green indicate lines that
73 you should add to your project. Lines to remove have a "-" in the
74 left hand column and are coloured red.
75
76 On the other hand, if you see something that looks like code but has a
77 "$" in the left hand column -- those aren't patches! Those are
78 commands that you can type into your command terminal.
eab7343 @bryanlarsen Up to part 1.
bryanlarsen authored
79 ---
23cb6e4 @bryanlarsen Round tripped the patches. Fixed up the errors caused by the round
bryanlarsen authored
80 README | 23 +++++++++++++++++++++++
81 1 files changed, 23 insertions(+), 0 deletions(-)
82
83 diff --git a/README b/README
08732dd @bryanlarsen first pass at Hobo 1.3 support. Selenium & Translation chapters are
bryanlarsen authored
84 index e69de29..2cb56ef 100644
23cb6e4 @bryanlarsen Round tripped the patches. Fixed up the errors caused by the round
bryanlarsen authored
85 --- a/README
86 +++ b/README
87 @@ -0,0 +1,23 @@
88 +# Agility
89 +
90 +This is the source code to accompany the [Agility gitorial for
91 +Hobo](http://cookbook.hobocentral.net/gitorials/agility).
92 +
93 +Agility is a simple "Agile Development" application – Agility. The
94 +application tracks projects which consist of a number of user
95 +stories. Stories have a status (e.g. accepted, under development…) as
96 +well as a number of associated tasks. Tasks can be assigned to users,
97 +and each user can see a heads-up of all the tasks they’ve been
98 +assigned to on their home page.
99 +
100 +To keep the gitorial clean, updates to the gitorial **rewrite
101 +history**. That means that you cannot `git pull`. If you wish to
102 +update to a later version, you must `git clone` the repository again
103 +and move any changes you have made from your old clone to the new one.
104 +
105 +The "real" history is kept in our [source
08732dd @bryanlarsen first pass at Hobo 1.3 support. Selenium & Translation chapters are
bryanlarsen authored
106 +repository](http://github.com/Hobo/agility-gitorial-patches/tree/master).
23cb6e4 @bryanlarsen Round tripped the patches. Fixed up the errors caused by the round
bryanlarsen authored
107 +
108 +There is a [version of
109 +agility](http://github.com/tablatom/agility/tree/master) that is not
08732dd @bryanlarsen first pass at Hobo 1.3 support. Selenium & Translation chapters are
bryanlarsen authored
110 +in gitorial format. That tree is mainly used for integration testing Hobo.
Something went wrong with that request. Please try again.