From 9ef8aadbd7d9a6dff82fd12fe95818095510e131 Mon Sep 17 00:00:00 2001 From: superplane39 Date: Mon, 29 Jun 2020 11:17:53 +0300 Subject: [PATCH 1/3] Add help articles on referencing and articles (both referenced in #15) --- User-Help/Articles.md | 9 +++++++++ User-Help/ReferencingGuidelines.md | 18 ++++++++++++++++++ 2 files changed, 27 insertions(+) create mode 100644 User-Help/Articles.md create mode 100644 User-Help/ReferencingGuidelines.md diff --git a/User-Help/Articles.md b/User-Help/Articles.md new file mode 100644 index 0000000..59219e7 --- /dev/null +++ b/User-Help/Articles.md @@ -0,0 +1,9 @@ +## Articles and blogs + +In addition to just Q&A, here on Codidact each site can also add several different categories of posts. This is useful for different types of knowlege sharing, as well as for site activities and community building. One of the main types of post categories, aside from Q&A, is articles. + +One of the main technical differences between articles and Q&A is that articles can't be answered, as well as having a `/articles/` path in the post URL. + +Aside from that, articles can be used in several different ways. Some sites have a blog, where people can post about topics that are of interest to that community, as well as site updates (and, really, whatever that site decides). Other sites use articles to post information that doesn't quite fit in a Q&A format - such as tutorials, reviews, or recommendations. + +If your site doesn't currently have articles or a blog, you can post a proposal in your site's meta category with your arguments for why your community would benefit from adding other categories and what categories you'd like to add. diff --git a/User-Help/ReferencingGuidelines.md b/User-Help/ReferencingGuidelines.md new file mode 100644 index 0000000..52a25af --- /dev/null +++ b/User-Help/ReferencingGuidelines.md @@ -0,0 +1,18 @@ +## Guidelines for referencing and quoting on Codidact sites + +When you're writing a post, referencing and quoting external material is a great way to back up your posts, provide sources, and increase the quality of what you're writing. There are, however, a few thing to keep in mind when quoting external material. + +**Referencing online material** + +When you're referencing or quoting material that can be found online (such as [Wikipedia](https://en.wikipedia.org/ "English Wikipedia") or similar), **please make sure to include a link**. +Pay attention to what license the content is published under - for instance, Wikipedia licenses text under the [Creative Commons Attribution-ShareAlike 3.0 license](https://en.wikipedia.org/wiki/Wikipedia:Text_of_Creative_Commons_Attribution-ShareAlike_3.0_Unported_License), which requires attribution and a link back to the original source. + + +**Referencing offline material** + +When quoting from offline material, such as a book, please make sure to always include at a very minimum the **title and author** of the work. Including a chapter number or page number when applicable is ideal. +Be sure to only quote whatever text is relevant. While quoting for knowlege sharing usually falls under [Fair Use rules](https://en.wikipedia.org/wiki/Fair_use), which allows the use of copyrighted material, limiting the sharing of copyrighted works to only what's necessary for your post is in general a good idea. + +--- + +In any case, whether your original source is online or offline, **please *clearly* mark the quoted material as being quoted** from somewhere and is not your original content. This is done simplest with blockquote formatting (see the [formatting help](/help/formatting) for help with formatting). From 58a50086c40b655746ebbf61b1ccfea0dd2d82c9 Mon Sep 17 00:00:00 2001 From: Mithical Date: Tue, 30 Jun 2020 12:18:55 +0300 Subject: [PATCH 2/3] Update Articles.md --- User-Help/Articles.md | 27 ++++++++++++++++++++++----- 1 file changed, 22 insertions(+), 5 deletions(-) diff --git a/User-Help/Articles.md b/User-Help/Articles.md index 59219e7..242f96d 100644 --- a/User-Help/Articles.md +++ b/User-Help/Articles.md @@ -1,9 +1,26 @@ -## Articles and blogs +## Categories and post types -In addition to just Q&A, here on Codidact each site can also add several different categories of posts. This is useful for different types of knowlege sharing, as well as for site activities and community building. One of the main types of post categories, aside from Q&A, is articles. +In addition to just Q&A, here on Codidact each site can also add several different categories of posts. This is useful for different types of knowlege sharing, as well as for site activities and community building. These categories can contain different post types. -One of the main technical differences between articles and Q&A is that articles can't be answered, as well as having a `/articles/` path in the post URL. +**Post types** -Aside from that, articles can be used in several different ways. Some sites have a blog, where people can post about topics that are of interest to that community, as well as site updates (and, really, whatever that site decides). Other sites use articles to post information that doesn't quite fit in a Q&A format - such as tutorials, reviews, or recommendations. +Currently, we have two main post types: Q&A (questions and answers), and articles. -If your site doesn't currently have articles or a blog, you can post a proposal in your site's meta category with your arguments for why your community would benefit from adding other categories and what categories you'd like to add. +Q&A is what forms, in most cases, the majority of the content on the site. Both the default Q&A and Meta categories use the Q&A post type. + +One of the main technical differences between articles and Q&A is that articles can't be answered, as well as having a `/articles/` path in the post URL. (Q&A uses a `/questions/` path.) + +Articles can be used in several different ways. Some sites have a blog, where people can post about topics that are of interest to that community, as well as site updates (and, really, whatever that site decides). Other sites use articles to post information that doesn't quite fit in a Q&A format - such as tutorials, reviews, or recommendations. + +**Categories** + +By default, all sites start out with two main category types: Main Q&A, which is where the main Q&A content for the site goes; and Meta, where people can discuss the site itself. + +In additon, many sites have additional categories. For instance, [Writing](https://writing.codidact.com) has a category for Writing Challenges, while [Cooking](https://cooking.codidact.com) has a category for sharing Recipes. + +A category can use the Q&A post type, such as Writing's writing challenges, where people post entries as answers to a question; or they can use an article post type, such as Cooking's recipes; or they can use both, and have both articles and Q&A allowed in that category. + +--- + + +If your site doesn't currently have a blog or another category that you'd like to see, you can post a proposal in your site's Meta category with your arguments for why your community would benefit from adding other categories and what categories you'd like to add. From d288a0f429051a1f527da313eed77f8aceeaacd3 Mon Sep 17 00:00:00 2001 From: Mithical Date: Tue, 30 Jun 2020 19:02:54 +0300 Subject: [PATCH 3/3] Update Articles.md --- User-Help/Articles.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/User-Help/Articles.md b/User-Help/Articles.md index 242f96d..9868cc4 100644 --- a/User-Help/Articles.md +++ b/User-Help/Articles.md @@ -16,7 +16,7 @@ Articles can be used in several different ways. Some sites have a blog, where pe By default, all sites start out with two main category types: Main Q&A, which is where the main Q&A content for the site goes; and Meta, where people can discuss the site itself. -In additon, many sites have additional categories. For instance, [Writing](https://writing.codidact.com) has a category for Writing Challenges, while [Cooking](https://cooking.codidact.com) has a category for sharing Recipes. +In additon, many sites have additional categories. For instance, [Writing](https://writing.codidact.com) has a category for Writing Challenges, [Cooking](https://cooking.codidact.com) has a category for sharing Recipes, and [Codidact Meta](https://meta.codidact.com) has a category for a [site Blog](https://meta.codidact.com/categories/30) (where the Codidact Team shares updates). A category can use the Q&A post type, such as Writing's writing challenges, where people post entries as answers to a question; or they can use an article post type, such as Cooking's recipes; or they can use both, and have both articles and Q&A allowed in that category.