Skip to content

Commit d13e585

Browse files
espenakespenak
committed
Better help section (#432).
1 parent 84cbf57 commit d13e585

2 files changed

Lines changed: 134 additions & 58 deletions

File tree

‎index.html‎

Lines changed: 93 additions & 44 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,11 @@
33
title: Devilry
44
forumurl: https://groups.google.com/forum/#!forum/devilry-help
55
forumnewtopicurl: https://groups.google.com/forum/#!newtopic/devilry-help
6-
issuetrackerurl: https://groups.google.com/forum/#!newtopic/devilry-help
6+
issuetrackerurl: https://github.com/devilry/devilry-django/issues?state=open
7+
issuetrackernewissueurl: https://github.com/devilry/devilry-django/issues/new
8+
wikiurl: https://github.com/devilry/devilry-django/wiki
9+
licenseurl: https://github.com/devilry/devilry-django/blob/master/LICENSE
10+
repourl: https://github.com/devilry/devilry-django
711
facebookurl: https://www.facebook.com/DevilryProsjektet
812
---
913

@@ -26,7 +30,7 @@
2630
<li class="active"><a href="#">Home</a></li>
2731
<li><a href="#social">Get involved</a></li>
2832
<li><a href="#about">About</a></li>
29-
<li><a href="#help">Help</a></li>
33+
<li><a href="#help">Help/docs</a></li>
3034
<li><a href="#develop">Develop</a></li>
3135
</ul>
3236
</div>
@@ -108,7 +112,7 @@
108112
<!--<img class="img-circle" data-src="holder.js/140x140">-->
109113
<i class="icon-tag marketing-huge-icon"></i>
110114
<h2>About</h2>
111-
<p>Devilry is a system for handling electronic deliveries. The system is designed to be flexible and customizable so that many different needs can be met. Devilry is designed to work with all types of electronic deliveries.</p>
115+
<p>Devilry is a system optimized for delivering and correcting electronic deliveries. This narrow focus enables us to avoid unneeded clutter common to less focused systems.</p>
112116
<p><a class="btn" href="#about">Read more&raquo;</a></p>
113117
</div><!-- /.span4 -->
114118
<div class="span4">
@@ -123,28 +127,29 @@ <h2>Help</h2>
123127
<i class="icon-puzzle-piece marketing-huge-icon"></i>
124128
<h2>Develop</h2>
125129
<p>Devilry is open source, and we have an open community. This means that you can help us develop Devilry.</p>
126-
<p><a class="btn" href="#developer">Read more&raquo;</a></p>
130+
<p><a class="btn" href="#develop">Read more&raquo;</a></p>
127131
</div><!-- /.span4 -->
128132
</div><!-- /.row -->
129133

130134

131-
<!-- START THE FEATURETTES -->
132-
133-
<hr class="featurette-divider">
134135

135136
<div class="featurette" id="social">
137+
<hr class="featurette-divider">
138+
136139
<div class="featurette-graphics">
137140
<div class="fb-like-box stacked-box" data-href="{{ page.facebookurl }}" data-width="300" data-height="320" data-show-faces="true" data-stream="false" data-show-border="true" data-header="false"></div>
138-
<a class="stacked-box btn btn-success btn-large" href="https://github.com/devilry/devilry-django/issues/new">
139-
<i class="icon-github"></i>
140-
Submit an issue
141-
<small>improvements, new features or bugs</small>
142-
</a>
143-
<a class="stacked-box btn btn-success btn-large" href="https://groups.google.com/forum/#!newtopic/devilry-help">
144-
<i class="icon-edit"></i>
145-
Create a forum topic
146-
<small>discuss all matters concerning Devilry</small>
147-
</a>
141+
<div class="stacked-buttons">
142+
<a class="btn btn-success btn-large" href="{{ page.issuetrackernewissueurl }}">
143+
<i class="icon-bug"></i>
144+
Submit an issue
145+
<small class="meta">improvements, new features or bugs</small>
146+
</a>
147+
<a class="btn btn-success btn-large" href="https://groups.google.com/forum/#!newtopic/devilry-help">
148+
<i class="icon-edit"></i>
149+
Create a forum topic
150+
<small class="meta">discuss all matters concerning Devilry</small>
151+
</a>
152+
</div>
148153
</div>
149154

150155
<h2>Get involved. <span class="muted">Join a open and friendly community.</span></h2>
@@ -154,7 +159,7 @@ <h2>Get involved. <span class="muted">Join a open and friendly community.</span>
154159
appreciate comments and guiding input from the community.
155160
Suggest improvements and report bugs through our
156161
<a href="{{ page.issuetrackerurl }}">issue tracker</a>,
157-
or discuss broader topics in our <a href="{{ page.forumurl }}">Forum</a>.
162+
or discuss broader topics in our <a href="{{ page.forumurl }}">forum</a>.
158163
</p>
159164
<p>
160165
There are many ways to contribute to the
@@ -170,39 +175,61 @@ <h2>Get involved. <span class="muted">Join a open and friendly community.</span>
170175
</p>
171176
</div>
172177

173-
<hr class="featurette-divider" id="about">
174178

175-
<div class="featurette" id="">
179+
<div class="featurette" id="about">
180+
<hr class="featurette-divider">
181+
176182
<div class="featurette-graphics">
177183
<!--<img alt="Devilry logo" src="devilrylogo-large.png"/>-->
178184
<i class="icon-tag featurette-huge-icon"></i>
179185
</div>
180186
<h2>About Devilry. <span class="muted">Why people love it.</span></h2>
181-
182-
<p class="lead">Devilry started out in 2008 by a group of students at
183-
the Department of Informatics, University of Oslo with a vision to improve
184-
the current solutions around deliveries of obligatory assignments.
185-
Devilry is designed to be flexible and customizable with a minimal
186-
maintainability cost.
187-
</p>
187+
<p class="lead">We focus on making it efficient and easy to provide
188+
feedback to students. This lets teachers/correctors focus on giving
189+
good feedback instead of other administrative tasks. We provide a
190+
minimalistic user interface for students, where they upload deliveries,
191+
and view feedback, and a sleek and intuitive user interface for
192+
course administrators and higher level administrators.</p>
193+
194+
<p>Devilry is designed with higher education in mind. This means that
195+
we do not cluttre the system with any of those artifical and uneeded
196+
constructs, like classrooms or folders. Instead, we try to give each
197+
user the shortest and most intuitive path to perform their tasks.</p>
198+
188199
<p>The system can handle all kinds of deliveries
189200
from source code to essays. On top a simple and easy-to-use delivery
190201
layer Devilry provides a sophisticated interface for examiners and
191202
teaching assistants to manage student group directly in their favorite
192203
browser. Course administrators are given a focused interface to be able
193204
to easily manage all formalities around course management, from task
194205
deadlines to exam lists.</p>
195-
<p>Devilry is currently the main delivery management system used at the
196-
Department of Informatics, UiO with plans of expanding to span across
197-
all departments at the The Faculty of Mathematics and Natural Sciences,
198-
UiO.</p>
206+
207+
<p>Devilry started out in 2008 by a group of students at the Department
208+
of Informatics, University of Oslo with a vision to improve the current
209+
solutions around deliveries of obligatory assignments. It is currently
210+
the main delivery management system used at the Department of
211+
Informatics, UiO with plans of expanding to span across all departments
212+
at the The Faculty of Mathematics and Natural Sciences, UiO.</p>
199213
</div>
200214

201-
<hr class="featurette-divider">
202215

203216
<div class="featurette" id="help">
204-
<div class="featurette-graphics featurette-graphics-left">
217+
<hr class="featurette-divider">
218+
219+
<div class="featurette-graphics">
205220
<i class="icon-comments featurette-huge-icon"></i>
221+
<div class="stacked-buttons">
222+
<a class="btn btn-success btn-large" href="{{ page.issuetrackernewissueurl }}">
223+
<i class="icon-bug"></i>
224+
Submit an issue
225+
<small class="meta">improvements, new features or bugs</small>
226+
</a>
227+
<a class="btn btn-success btn-large" href="https://groups.google.com/forum/#!newtopic/devilry-help">
228+
<i class="icon-edit"></i>
229+
Create a forum topic
230+
<small class="meta">discuss all matters concerning Devilry</small>
231+
</a>
232+
</div>
206233
</div>
207234
<h2>Get help. <span class="muted">Or help someone else.</span></h2>
208235

@@ -213,33 +240,55 @@ <h2>Get help. <span class="muted">Or help someone else.</span></h2>
213240
Visit our <a href="{{ page.issuetrackerurl }}">issue tracker</a>
214241
and submit or help with bugs and suggestions. Visit our
215242
<a href="{{ page.forumurl }}">forum</a> to get help, or to discuss
216-
all matters concerning Devilry. Become a part of our community now!
243+
all matters concerning Devilry. Follow the links below to go to the
244+
appropriate parts of our documentation.
217245
</p>
246+
<p class="buttonbar">
247+
<a class="btn btn-large btn-primary" href="https://devilry-userdoc.readthedocs.org">
248+
<i class="icon-user"></i>
249+
User docs
250+
<small class="meta">Students, examiners, admins</small>
251+
</a>
252+
<a class="btn btn-large btn-primary" href="https://devilry-deploy.readthedocs.org">
253+
<!--<i class="icon-fire-extinguisher"></i>-->
254+
<i class="icon-coffee"></i>
255+
Sysadmin docs
256+
<small class="meta">Setup, deploy and update</small>
257+
</a>
258+
<a class="btn btn-large" href="{{ page.wikiurl }}">
259+
<i class="icon-github"></i>
260+
Wiki
261+
<small class="meta">... everything else</small>
262+
</a>
263+
</p>
264+
<p class="muted"><small>
265+
All our documentation is open source projects where anyone can
266+
contribute. For the User and Sysadmin docs, we have a big green box
267+
on the frontpage with more info. All you need is a
268+
<a href="http://github.com">GitHub</a> user. The Wiki is open for
269+
anyone with a GitHub user.
270+
</small></p>
218271

219272
</div>
220273

221-
<div class="featurette" id="developer">
274+
<div class="featurette" id="develop">
275+
<hr class="featurette-divider">
276+
222277
<div class="featurette-graphics">
223278
<!--<img alt="Devilry logo" src="devilrylogo-large.png"/>-->
224279
<i class="icon-puzzle-piece featurette-huge-icon"></i>
225280
</div>
226281
<h2>Develop Devilry. <span class="muted">We will help you get started.</span></h2>
227282
<p class="lead">
228-
Developers can clone <a href="https://github.com/devilry/devilry-django">our repository</a>
283+
Developers can clone <a href="{{ page.repourl }}">our repository</a>
229284
at GitHub and start right away. The
230285
<a href="http://devilry.readthedocs.org/en/latest/">Devilry Devoloper Documentation</a>
231286
will guide you in the right direction. Feel free to consult
232287
the <a href="https://groups.google.com/forum/#!forum/devilry-help">Devilry Help Questions and Answers</a> forum for further help on all matters concerning Devilry.
233288
</p>
234-
<p>The Devilry source code is released with the the <a href="https://github.com/devilry/devilry-django/blob/master/LICENSE">BSD license</a>, which is an open source license.</p>
289+
<p>The Devilry source code is released with the the <a href="{{ page.licenseurl }}">BSD license</a>, which is an open source license.</p>
235290
</div>
236-
237-
<hr class="featurette-divider">
238-
239-
<!-- /END THE FEATURETTES -->
240-
241-
242-
</div><!-- /.container -->
291+
</div>
243292

244293

245294

‎less/featurette.less‎

Lines changed: 41 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -2,38 +2,49 @@
22
@featuretteMarginTop: 120px;
33

44

5-
.featurette-divider {
6-
margin: 80px 0; /* Space out the Bootstrap <hr> more */
5+
6+
.btn-large {
7+
small.meta {
8+
display: block;
9+
font-size: @baseFontSize - 4px;
10+
}
711
}
12+
13+
814
.featurette {
9-
padding-top: @featuretteMarginTop; /* Vertically center images part 1: add padding above and below text. */
15+
//padding-top: @featuretteMarginTop; /* Vertically center images part 1: add padding above and below text. */
1016
overflow: hidden; /* Vertically center images part 2: clear their floats. */
17+
18+
.featurette-divider {
19+
margin: 80px 0 @featuretteMarginTop+80px 0;
20+
}
1121
.featurette-graphics {
1222
float: right;
1323
margin: -@featuretteMarginTop 0 @featuretteMarginSides @featuretteMarginSides;
1424
i.featurette-huge-icon {
1525
font-size: 420px;
1626
}
17-
.stacked-box {
18-
margin-bottom: 10px;
19-
&.btn {
27+
.stacked-buttons {
28+
width: 300px;
29+
.box-sizing(border-box);
30+
margin: 0 auto 0 auto;
31+
.btn {
32+
margin-top: 10px;
33+
display: block;
2034
position: relative;
35+
padding-left: 70px;
36+
text-align: left;
2137
i {
2238
position: absolute;
2339
top: 8px;
2440
left: 12px;
2541
font-size: 45px;
2642
}
27-
padding-left: 70px;
28-
text-align: left;
29-
display: block;
30-
small {
31-
display: block;
32-
font-size: @baseFontSize - 4px;
33-
}
3443
}
3544
}
36-
&.featurette-graphics-left {
45+
}
46+
&:nth-child(odd) {
47+
.featurette-graphics {
3748
float: left;
3849
margin: -@featuretteMarginTop @featuretteMarginSides @featuretteMarginSides 0;
3950
}
@@ -44,6 +55,22 @@
4455
line-height: 1;
4556
letter-spacing: -1px;
4657
}
58+
&#help {
59+
.buttonbar {
60+
line-height: 74px;
61+
.btn-large {
62+
position: relative;
63+
i {
64+
position: absolute;
65+
top: 8px;
66+
left: 10px;
67+
font-size: 45px;
68+
}
69+
padding-left: 65px;
70+
text-align: left;
71+
}
72+
}
73+
}
4774
}
4875
//.featurette-image {
4976
//margin-top: -120px; /* Vertically center images part 3: negative margin up the image the same amount of the padding to center it. */

0 commit comments

Comments
 (0)