Last modified by Patrick Masson on 2020/04/28 20:05

Hide last authors
Patrick Masson 3.1 1 The discussions occurring on both the [[License Discuss>>url:https://lists.opensource.org/pipermail/license-discuss_lists.opensource.org/]] and [[License Review>>url:https://lists.opensource.org/pipermail/license-review_lists.opensource.org/]] mailing lists are summarized in monthly reports and then posted back to the corresponding mailing lists and the OSI website.
Patrick Masson 1.1 2
Patrick Masson 3.1 3 In order to ensure the reports and summaries of discussions are **usable**, **concise**, and **consistent** the following style guidelines have been adopted.
Patrick Masson 1.1 4
Patrick Masson 3.1 5 **~1. Report Title**
Patrick Masson 1.1 6
Patrick Masson 2.1 7 * The monthly License-Discuss report is titled, "[MONTH] [YEAR] License-Discuss Report"
8 ** The URL for the License-Discuss report is formatted as, "https://opensource.org/LicenseDiscuss[YYYYMM]"
9 * The monthly License-Review report is titled, "[MONTH] [YEAR] License-Review Report"
10 ** The URL for the License-Review report is formatted as, "https://opensource.org/LicenseReview[YYYYMM]"
Patrick Masson 1.1 11
Patrick Masson 3.1 12 **2. Introduction (website only)**
13
Patrick Masson 2.1 14 The OSI's content management system (Drupal), allows any "News" post (blog post) to include a summary of the contents on the OSI website's homepage.
Patrick Masson 3.1 15
Patrick Masson 2.1 16 * The homepage summary includes the content form the table of contents in paragraph form.
Patrick Masson 1.1 17
18 Example:
19
20 {{box}}
Patrick Masson 2.1 21 In [MONTH}, the License-[discuss/Review] mailing list discussed the [FIRST TOPIC SUBMITTED FOR THE MONTH], the [SECOND TOPIC SUBMITTED...], the [THIRD TOPIC...], and the [...].
22 {{/box}}
23
24 3. Table of Contents
25
26 * Each report will include a table of contents listing the topics discussed during the month.
27 * The order of the topics included in the table of contents is based on the date the topic was introduced to the mailing list: the oldest topics first, fol lowered by later topics added throughout the month.
28 * The table of contents will be included at the beginning of the report.
29
30 Example:
31
32 {{box}}
Patrick Masson 1.1 33 License-[Discuss/Review] mailing list topics for [MONTH] [YEAR]:
34
35 [FIRST TOPIC SUBMITTED FOR THE MONTH]
36 [SECOND TOPIC SUBMITTED...]
37 [THIRD TOPIC...]
38 [...]
39 {{/box}}
40
41 2. Topic Headers
42
Patrick Masson 3.1 43 * Each topic will be listed in the body of the report as a new header (Level 3 in Drupal's rich text editor).
Patrick Masson 1.1 44
45 3. Topic Introduction
46
Patrick Masson 3.1 47 * The first post of the thread for a new topic will be summarized to emphasize the specific issue (for L-D) or license (for L-R) introduced.
48 * The URL will be included as a link to the archived discussion post introducing the topic to the list.
49 ** This is correct, "[[https:~~/~~/lists.opensource.org/pipermail/license-discuss_lists.opensource.org/>>url:https://lists.opensource.org/pipermail/license-discuss_lists.opensource.org/]]"
50 ** This is incorrect, "[[Link to License-Discuss list archive>>url:http://For example,]]."
51 * Including the URL as a link allows those using "plain text" email clients to view the URL and also insures those reviewing the reports through the mailman archives can also see the URL to any references/resources.
Patrick Masson 1.1 52
53 4. Topic Discussions (Posts)
54
55 * Only discussion posts including additional relevant (on topic) issues should be included summarized in the report.
56 * Responses to the initial issue(s) should not be included. Readers can click to the thread to follow the discussion.
Patrick Masson 2.1 57
58 ----
59
60 Glossary of Terms
61
62 * Discussion - the thread of posts in response to a topic.
63 * Mailing List - a forum for email-based discussions managed by the OSI on the MailMan platform.
64 * Post - a message sent by a mailing list user to the mailing list forum.
65 * Report - the entire content of a month's License-Discuss and License-Review posted to the OSI website and corresponding mailing list.
66 * Summary - a brief transcript of a mailing list post send by a mailing list user.
Patrick Masson 3.1 67 * Thread - a list of posts related to a single topic in the mailing list.
Patrick Masson 2.1 68 * Topic - a single subject introduced to the License-Discuss or License-Review mailing list.
69 * Topic Header - the text included in a License-Discuss or License-Review report introducing a new topic.

Submit feedback regarding this wiki to [email protected]

This wiki is licensed under a Creative Commons 2.0 license
XWiki 14.10.13 - Documentation