Skip to content

Commit

Permalink
README.md: Change headers ("Students" -> "For leaners")
Browse files Browse the repository at this point in the history
This is based on swcarpentry/workshop-template@5451fb9c1 (Enumerating
setup/run instructions for installation test scripts, 2014-12-17).
Greg suggested he switch from "Students" to "Learners" because some
professors attend workshops as students but don't feel comfortable
being called students [1]?  Or something like that.  I don't mind
either way, so we'll just go with Greg's preference.

The addition of a "For" in the section headings seems like a good
change though, since it makes it clear that the noun in the heading
marks the intended audience for that section, not the intended
subject.

I went with 'Sentence case' titles because I think they're more
readable and it's easier to be consistent.  There are a number of
folks who agree with me [2,3], including (apparently) the Oxford Guide to
Style [4] (I'm ok with title case for book and organization titles ;).
Although the American Psychological Association perfers 'Title Case'
for the first two levels of headings as well [5].

[1]: https://github.com/swcarpentry/workshop-template/pull/89#issuecomment-67718126
[2]: http://www.snappysentences.com/sentence-case-v-title-case/
[3]: http://www.stickycontent.com/blog/are-you-team-title-case-or-team-sentence-case.php
[4]: http://ux.stackexchange.com/a/48620
[5]: http://blog.apastyle.org/apastyle/2012/03/title-case-and-sentence-case-capitalization-in-apa-style.html

Based-on-patch-by: Greg Wilson <gvwilson@third-bit.com>
  • Loading branch information
W. Trevor King committed Dec 20, 2014
1 parent cbfbc0f commit a314489
Showing 1 changed file with 4 additions and 4 deletions.
8 changes: 4 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
Students
========
For learners
============

This directory contains scripts for testing your machine to make sure
you have the software you'll need for your workshop installed. See
Expand Down Expand Up @@ -45,8 +45,8 @@ option:
os.name : posix

Instructors
===========
For instructors
===============

`swc-installation-test-1.py` is pretty simple, and just checks that
the students have a recent enough version of Python installed that
Expand Down

0 comments on commit a314489

Please sign in to comment.