Difference between revisions of "Blog Guidelines"

From CDOT Wiki
Jump to: navigation, search
m (Posting Guidelines)
(Blogs in DPS909/OSD600/SBR600/SPO600)
 
(22 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 +
<!-- {{Admon/important|Content being Updated|This page is in the process of being updated from a previous semester's content. It is not yet updated for the current semester. Do not rely on the accuracy of this information until this warning is removed.}} -->
 +
 
=Introduction=
 
=Introduction=
  
 
In the open source world blogs are one of the main vehicles for general discussions about technical and project issues.  One of the main reasons for this is that open source projects are interconnected, and developers working on one project want to follow what is happening in other projects.  Users also like to know what is happening behind the scenes with their favourite software.  Blogging is a great way to reach new people who share similar interests to you.  Sites like http://digg.com, http://slashdot.org, and others facilitate this.
 
In the open source world blogs are one of the main vehicles for general discussions about technical and project issues.  One of the main reasons for this is that open source projects are interconnected, and developers working on one project want to follow what is happening in other projects.  Users also like to know what is happening behind the scenes with their favourite software.  Blogging is a great way to reach new people who share similar interests to you.  Sites like http://digg.com, http://slashdot.org, and others facilitate this.
  
The volume of blog postings created within a community can be overwhelming. To help deal with this, RSS or Atom feeds enable the receipt of content in a machine-readable format so that it can be used in a variety of different ways (for example, in Firefox [http://www.mozilla.com/en-US/firefox/livebookmarks.html Live Bookmarks], through a service such as [http://www.google.com/reader Google Reader], or in a program such as [http://liferea.sourceforge.net/ Lifrea] or [http://www.feedreader.com/ FeedReader]).
+
The volume of blog postings created within a community can be overwhelming. To help deal with this, RSS or Atom feeds enable the receipt of content in a machine-readable format so that it can be used in a variety of different ways.  
 +
 
 +
Many open-source community maintain a [http://planetplanet.org Planet] site which aggregates the feeds from community members into a single page (and the Planet, in turn, provides an aggregated feed). Here are some examples:
 +
 
 +
* The Mozilla Planet - http://planet.mozilla.org
 +
* Fedora Planet - http://planet.fedoraproject.org/
  
Many open-source community maintain a [http://planetplanet.org Planet] site which aggregates the feeds from community members into a single page (and the Planet, in turn, provides an aggregated feed). The Mozilla planet is at http://planet.mozilla.org -- other open source planets include http://planet.gnome.org and http://planet.fedoraproject.org.
+
The Seneca open source Planet is [https://telescope.cdot.systems Telescope].
  
=Blogs in DPS909/OSD600=
+
= Blogs in SPO600 =
  
 
You are required to blog '''twice''' per week on things related to the course, your project, your readings, etc.  If you haven't blogged before, spend some time reading other people's blogs.
 
You are required to blog '''twice''' per week on things related to the course, your project, your readings, etc.  If you haven't blogged before, spend some time reading other people's blogs.
  
You are also encouraged to comment on other people's blog posts when you have something to say in reply.  Blog comments allow two way communication, and help blog authors understand how their views are being received.
+
You are also encouraged to comment on other people's blog posts when you have something to say in reply, either directly (by leaving a comment on their blog) or by creating a blog entry of your own that links to the other's blog (most blog software will automatically link the postings using a "Trackback" mechanism)The makes the blog a two way communication medium, and help blog authors understand how their views are being received.
 +
 
 +
= Blogs in Other Courses =
 +
 
 +
You will receive separate blogging instructions for each of your courses. In general, you'll submit some of your weekly work and project reports by blogging. You are also encouraged to comment on postings by other people.
  
=Posting Guidelines=
+
= Posting Guidelines =
  
Your blog is an integral part of your work in [[DPS909]]/[[OSD600]]. Blog postings will be made available to other students, faculty, and the general public via the web and your RSS/Atom feeds, and your postings will appear on the [http://zenit.senecac.on.ca/~chris.tyler/planet OpenSource@Seneca Planet]. The Planet feed will in turn be picked up and used in a number of very public places, including a crawl on the [http://cs.senecac.on.ca/ CS homepage].
+
Your blog is an integral part of your work in your open source course(s). Blog postings will be made available to other students, faculty, and the general public via the web and your RSS/Atom feeds, and your postings will appear on [https://telescope.cdot.systems Telescope].
  
 
Because your blog postings will be incorporated into other content, it is important that you represent your thoughts professionally, using these guidelines:
 
Because your blog postings will be incorporated into other content, it is important that you represent your thoughts professionally, using these guidelines:
  
 +
* '''Provide context''' so that someone happening across your blog post will understand what you are talking about.
 
* '''Write professionally.''' Blog postings are less formal than other types of writing, but they are still a reflection of your communications skills.
 
* '''Write professionally.''' Blog postings are less formal than other types of writing, but they are still a reflection of your communications skills.
* '''Remember that the internet has a long memory.''' The Planet page is generated once an hour, and even if you delete or change your posting, it may be indexed, cached, or reposted during that hour. Avoid saying something that might come back to haunt you later -- and remember that future employers may read your old postings (as well as future in-laws, office mates, and so forth).
+
* '''Remember that the internet has a long memory.''' The Telescope page is generated periodically, and even if you delete or change your posting, it may be indexed, cached, or reposted in the previous form. Avoid saying something that might come back to haunt you later -- and remember that future employers may read your old postings (as well as future in-laws, office mates, and so forth).
 +
* '''Write in English.''' English is the language of instruction at Seneca and the main language of communication in many open source communities.
 +
* '''Define appreviations and acronyms''' the first time each one is used.
 
* '''Do not use profane, obscene, or rude content, or content that belittles other people.'''
 
* '''Do not use profane, obscene, or rude content, or content that belittles other people.'''
 
* '''Do not link to profane, obscene, rude, or illegal material or to sites that knowingly violate intellectual property rights''' (warez).
 
* '''Do not link to profane, obscene, rude, or illegal material or to sites that knowingly violate intellectual property rights''' (warez).
 
* '''Ensure that each posting makes sense when taken out of the context of your blog and viewed on its own.''' If you are referring to one of your previous posts, link to it rather than refer to it as being "below" or "above".
 
* '''Ensure that each posting makes sense when taken out of the context of your blog and viewed on its own.''' If you are referring to one of your previous posts, link to it rather than refer to it as being "below" or "above".
 +
* '''Link extensively'''. If you're referring to a blog post, article, video, event, command, software package, person, project -- link to all of them so that your readers can find out more information.
 +
* '''Use text instead of screenshots whenever possible''' so that your pages are searchable, resizable, and accessible.
 
* '''Ensure that each posting conforms to the [http://www.senecac.on.ca/policies/itau.html Seneca AUP]'''
 
* '''Ensure that each posting conforms to the [http://www.senecac.on.ca/policies/itau.html Seneca AUP]'''
 
* '''Keep the postings relevant to your open source work'''.
 
* '''Keep the postings relevant to your open source work'''.
  
Failure to follow these guidelines will result in removal of your feed from the Planet, and in a severe case (such as a breach of the AUP) may result in disciplinary action from the college.
+
Failure to follow these guidelines may result in removal of your feed from Telescope, and in a severe case (such as a breach of the AUP) may result in disciplinary action from the college.
  
 
Please note that if you want to create blog entries that may not conform to these guidelines, you are free to do so in one of two ways:
 
Please note that if you want to create blog entries that may not conform to these guidelines, you are free to do so in one of two ways:
  
 
# Create a separate blog for your personal postings.
 
# Create a separate blog for your personal postings.
# Use a feed for the Planet that only includes articles tagged with a certain word or classified into a certain category, and then ensure that articles that do not meet these guidelines are not tagged or classified in such a way that they are picked up in the feed. See [[Open Source@Seneca Planet List]].
+
# Use a feed for the Telescope that only includes articles tagged with a certain word or classified into a certain category, and then ensure that articles that do not meet these guidelines are not tagged or classified in such a way that they are picked up in the feed.
 +
 
 +
 
 +
= Access to Blog Posts =
 +
 
 +
It's important that your professor be able to easily access your blog posts for a particular date range. Some blog software and blog ''themes'' provide easy access to your posts and some make it very difficult. Please don't frustrate your prof -- and risk having them miss some of yours posts! -- by using a configuration that makes it hard to find your posts.

Latest revision as of 10:58, 13 September 2022


Introduction

In the open source world blogs are one of the main vehicles for general discussions about technical and project issues. One of the main reasons for this is that open source projects are interconnected, and developers working on one project want to follow what is happening in other projects. Users also like to know what is happening behind the scenes with their favourite software. Blogging is a great way to reach new people who share similar interests to you. Sites like http://digg.com, http://slashdot.org, and others facilitate this.

The volume of blog postings created within a community can be overwhelming. To help deal with this, RSS or Atom feeds enable the receipt of content in a machine-readable format so that it can be used in a variety of different ways.

Many open-source community maintain a Planet site which aggregates the feeds from community members into a single page (and the Planet, in turn, provides an aggregated feed). Here are some examples:

The Seneca open source Planet is Telescope.

Blogs in SPO600

You are required to blog twice per week on things related to the course, your project, your readings, etc. If you haven't blogged before, spend some time reading other people's blogs.

You are also encouraged to comment on other people's blog posts when you have something to say in reply, either directly (by leaving a comment on their blog) or by creating a blog entry of your own that links to the other's blog (most blog software will automatically link the postings using a "Trackback" mechanism). The makes the blog a two way communication medium, and help blog authors understand how their views are being received.

Blogs in Other Courses

You will receive separate blogging instructions for each of your courses. In general, you'll submit some of your weekly work and project reports by blogging. You are also encouraged to comment on postings by other people.

Posting Guidelines

Your blog is an integral part of your work in your open source course(s). Blog postings will be made available to other students, faculty, and the general public via the web and your RSS/Atom feeds, and your postings will appear on Telescope.

Because your blog postings will be incorporated into other content, it is important that you represent your thoughts professionally, using these guidelines:

  • Provide context so that someone happening across your blog post will understand what you are talking about.
  • Write professionally. Blog postings are less formal than other types of writing, but they are still a reflection of your communications skills.
  • Remember that the internet has a long memory. The Telescope page is generated periodically, and even if you delete or change your posting, it may be indexed, cached, or reposted in the previous form. Avoid saying something that might come back to haunt you later -- and remember that future employers may read your old postings (as well as future in-laws, office mates, and so forth).
  • Write in English. English is the language of instruction at Seneca and the main language of communication in many open source communities.
  • Define appreviations and acronyms the first time each one is used.
  • Do not use profane, obscene, or rude content, or content that belittles other people.
  • Do not link to profane, obscene, rude, or illegal material or to sites that knowingly violate intellectual property rights (warez).
  • Ensure that each posting makes sense when taken out of the context of your blog and viewed on its own. If you are referring to one of your previous posts, link to it rather than refer to it as being "below" or "above".
  • Link extensively. If you're referring to a blog post, article, video, event, command, software package, person, project -- link to all of them so that your readers can find out more information.
  • Use text instead of screenshots whenever possible so that your pages are searchable, resizable, and accessible.
  • Ensure that each posting conforms to the Seneca AUP
  • Keep the postings relevant to your open source work.

Failure to follow these guidelines may result in removal of your feed from Telescope, and in a severe case (such as a breach of the AUP) may result in disciplinary action from the college.

Please note that if you want to create blog entries that may not conform to these guidelines, you are free to do so in one of two ways:

  1. Create a separate blog for your personal postings.
  2. Use a feed for the Telescope that only includes articles tagged with a certain word or classified into a certain category, and then ensure that articles that do not meet these guidelines are not tagged or classified in such a way that they are picked up in the feed.


Access to Blog Posts

It's important that your professor be able to easily access your blog posts for a particular date range. Some blog software and blog themes provide easy access to your posts and some make it very difficult. Please don't frustrate your prof -- and risk having them miss some of yours posts! -- by using a configuration that makes it hard to find your posts.