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

From version 1.1 >
edited by Patrick Masson
on 2020/04/28 19:33
To version < 2.1 >
edited by Patrick Masson
on 2020/04/28 19:52
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,17 +1,33 @@
1 1  The discussions occurring on both the License Discuss and License Review mailing lists are summarized in monthly reports and posted back to the corresponding mailing lists and the OSI website.
2 2  
3 +In order to ensure the reports and summaries of discussions are usable, concise, and consistent the following style guidelines have been adopted.
3 3  
4 -In order to ensure the reports and summaries of posts are usable, concise, and consistent the following style guidelines have been adopted.
5 +~1. Report Title
5 5  
6 -~1. Introduction and Table of Contents
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]"
7 7  
8 -* Each topic introduced to the mailing list is included in a table of contents.
9 -* Topics included in the table of contents is based on the date the topic was introduced to the list: the oldest topics first, fol lowered by later topics added throughout the month.
10 -* The table of contents will be included first in the report, above and before the summaries of any discussion posts.
12 +2. Introduction (website only)
13 +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.
14 +* The homepage summary includes the content form the table of contents in paragraph form.
11 11  
12 12  Example:
13 13  
14 14  {{box}}
19 +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 [...].
20 +{{/box}}
21 +
22 +3. Table of Contents
23 +
24 +* Each report will include a table of contents listing the topics discussed during the month.
25 +* 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.
26 +* The table of contents will be included at the beginning of the report.
27 +
28 +Example:
29 +
30 +{{box}}
15 15  License-[Discuss/Review] mailing list topics for [MONTH] [YEAR]:
16 16  
17 17  [FIRST TOPIC SUBMITTED FOR THE MONTH]
... ... @@ -33,3 +33,16 @@
33 33  
34 34  * Only discussion posts including additional relevant (on topic) issues should be included summarized in the report.
35 35  * Responses to the initial issue(s) should not be included. Readers can click to the thread to follow the discussion.
52 +
53 +----
54 +
55 +Glossary of Terms
56 +
57 +* Discussion - the thread of posts in response to a topic.
58 +* Mailing List - a forum for email-based discussions managed by the OSI on the MailMan platform.
59 +* Post - a message sent by a mailing list user to the mailing list forum.
60 +* Report - the entire content of a month's License-Discuss and License-Review posted to the OSI website and corresponding mailing list.
61 +* Summary - a brief transcript of a mailing list post send by a mailing list user.
62 +* Topic - a single subject introduced to the License-Discuss or License-Review mailing list.
63 +* Topic Header - the text included in a License-Discuss or License-Review report introducing a new topic.
64 +

Submit feedback regarding this wiki to [email protected]

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