diff --git a/docs/images/release_report/add_wc_merge_word.png b/docs/images/release_report/add_wc_merge_word.png new file mode 100644 index 00000000..67f21e66 Binary files /dev/null and b/docs/images/release_report/add_wc_merge_word.png differ diff --git a/docs/images/release_report/committee_members.png b/docs/images/release_report/committee_members.png new file mode 100644 index 00000000..3118152e Binary files /dev/null and b/docs/images/release_report/committee_members.png differ diff --git a/docs/images/release_report/library_index_ranking.png b/docs/images/release_report/library_index_ranking.png new file mode 100644 index 00000000..939c4850 Binary files /dev/null and b/docs/images/release_report/library_index_ranking.png differ diff --git a/docs/images/release_report/library_quality_good.png b/docs/images/release_report/library_quality_good.png new file mode 100644 index 00000000..6d25acb7 Binary files /dev/null and b/docs/images/release_report/library_quality_good.png differ diff --git a/docs/images/release_report/library_quality_great.png b/docs/images/release_report/library_quality_great.png new file mode 100644 index 00000000..7e770605 Binary files /dev/null and b/docs/images/release_report/library_quality_great.png differ diff --git a/docs/images/release_report/release_report_button.png b/docs/images/release_report/release_report_button.png new file mode 100644 index 00000000..4041a7c3 Binary files /dev/null and b/docs/images/release_report/release_report_button.png differ diff --git a/docs/images/release_report/sponsor_message.png b/docs/images/release_report/sponsor_message.png new file mode 100644 index 00000000..e28e4089 Binary files /dev/null and b/docs/images/release_report/sponsor_message.png differ diff --git a/docs/images/release_report/user_profile_image.png b/docs/images/release_report/user_profile_image.png new file mode 100644 index 00000000..e3795466 Binary files /dev/null and b/docs/images/release_report/user_profile_image.png differ diff --git a/docs/images/release_report/wc_ignore.png b/docs/images/release_report/wc_ignore.png new file mode 100644 index 00000000..9cc3b7d2 Binary files /dev/null and b/docs/images/release_report/wc_ignore.png differ diff --git a/docs/images/release_report/wc_merge_word.png b/docs/images/release_report/wc_merge_word.png new file mode 100644 index 00000000..572a67d3 Binary files /dev/null and b/docs/images/release_report/wc_merge_word.png differ diff --git a/docs/release_reports.md b/docs/release_reports.md new file mode 100644 index 00000000..0a29b7fd --- /dev/null +++ b/docs/release_reports.md @@ -0,0 +1,71 @@ +# Release Reports + +1. Go to /admin +2. Go to the "Libraries" section +3. In the top menu click on "GET RELEASE REPORT". + ![release_report_button.png](images/release_report/release_report_button.png) +4. On the next page check "No cache" +5. Choose a version from the "version" dropdown and click submit + +## Configuration options + +### Fiscal Sponsorship Committee +To set the content, in the "Versions" section, set the value for "Sponsor message" to the text you want to see. + +![sponsor_message.png](images/release_report/sponsor_message.png) + +You should also add committe members under "Financial Committee Members", adding users from "Available financial committee members" to "Chosen financial committee members". These will be sorted alphabetically, and images are taken from the members' avatars. + +![committee_members.png](images/release_report/committee_members.png) + +To update the user's avatar, if the user has given permission, go to the user's profile in the "Users" section, abd set the avatar under "Image". + +![user_profile_image.png](images/release_report/user_profile_image.png) + +### Mailing List Word Cloud + +#### Merging Words + +To merge words, go to the "Wordlcoud merge words" section, and click on "ADD WORDCLOUD MERGE WORD". + +![add_wc_merge_word.png](images/release_report/add_wc_merge_word.png) + +Then you can add the word you want to merge, and the word you want to merge it into. + +e.g. in this case, all instances of "falco" in the list will be merged into "vinnie". + +By default all displayed words are lowercase. Should you want to have one that starts with a capital letter, you can do that using a merge word, which are applied after case is normalized. + +![wc_merge_word.png](images/release_report/wc_merge_word.png) + +#### Excluding Words + +To exclude a word go to the "Site Settings" section, open the site setting that exists, and under "Wordcloud ignore", add comma separated words you wish to have excluded from the word cloud. + +With the value as you can see it below we remove "\_\_(...)\_\_" because it's just formatting from the mailing list, and Boost because it's redundant. + +![wc_ignore.png](images/release_report/wc_ignore.png) + +## Slack Channel Descriptions + +These are retrieved from the "Description" field as set on the Slack channel itself. + +## Library Rankings +There are three "quality" rankings, semi-comparable to "great", "good", "standard". + +1. When a library is ranked as "great" it's prefixed by a filled star in the "Library Index". +2. When a library is ranked as "good" it's prefixed by an outlined star in the "Library Index". +3. When a library is ranked as "standard" it's prefixed by nothing in the "Library Index". + +The "Library Index" is ranked by quality while the library listing is ranked alphabetically. + +![library_index_ranking.png](images/release_report/library_index_ranking.png) + +By default, all libraries are ranked "standard". + +To set a library as "great", upload an image to the "Library Graphic" field to the library instance in the "Library" section. +![library_quality_great.png](images/release_report/library_quality_great.png) + +To set a library as "good", check "Good Library" in the library instance in the "Library" section. + +![library_quality_good.png](images/release_report/library_quality_good.png)