Difference between revisions of "Blog Guidelines"
Chris Tyler (talk | contribs) |
Chris Tyler (talk | contribs) (→Blogs in DPS909/OSD600/SBR600/SPO600) |
||
| (32 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
| − | Your blog is an integral part of your work in | + | <!-- {{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= | ||
| + | |||
| + | 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 [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/ | ||
| + | |||
| + | The Seneca open source Planet is [https://telescope.cdot.systems 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 [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: | ||
| − | * '''Write professionally.''' Blog postings are less formal than other types of writing, but they are still a reflection of your | + | * '''Provide context''' so that someone happening across your blog post will understand what you are talking about. |
| − | * '''Remember that the internet has a long memory.''' The | + | * '''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 use profane, obscene, or rude content, or content that belittles other people.''' | ||
| − | * '''Do not link to profane, obscene, 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 | + | 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 | + | # 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
Contents
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 Mozilla Planet - http://planet.mozilla.org
- Fedora Planet - http://planet.fedoraproject.org/
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:
- Create a separate blog for your personal postings.
- 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.
