teaching machines

On posting

July 9, 2012 by . Filed under meta.

For several of my classes, I ask students to contribute to this blog. If you are reading this page, you’re probably a student. You are given your own accounts and you will do your own posting. Collected here are some guidelines that I ask you to follow when publishing your content.

Identity

Please choose a display name that you feel comfortable sharing with the world. Remaining unidentifiable to the outside world is perfectly acceptable, but please choose a nickname that I can cross-reference when grading. To change how your name is displayed, go to Users, Your Profile.

Posting code

To include code in your posts, I strongly suggest you follow this procedure to ensure your code is displayed legibly and styled consistently with the rest of the site:

  1. Insert your cursor where you want the code to go.
  2. Choose Preformatted in the Format dropdown menu in the WordPress Visual Editor toolbar. Click the PRE button in the visual editor toolbar.
  3. Paste or type in your code.
  4. Surround your code with my custom shortcode tag:
    [precode]line 1
    line 2
    line 3[/precode]

Categories and tags

Posts are classified in WordPress with categories and tags. Semantically, categories and tags are not dissimilar. Categories are typically predetermined and be hierarchically organized. Tags are more free-form. Since the content of each course page is primarily generated by categories, please use categories when classifying your posts. Do not use tags.

Classes are categorized in two ways: by time and by course number. Whenever you post, make sure you check both the course number category and the semester category. If posting a post mortem, also check the post mortem category. Typically you will check these these three categories and no others.