Skip to content

Latest commit

 

History

History
77 lines (58 loc) · 3.77 KB

README.md

File metadata and controls

77 lines (58 loc) · 3.77 KB
Raw

drupal-meeting-parser

This is a bare bones Google Chrome extension to copy Drupal Slack meeting threads to the system clipboard.

Drupal Meeting Parser icon

Many Drupal teams use threaded meetings to discuss current topics. This extension helps to archive the meeting log from these meetings for posterity. Crediting meeting participants is facilitated as well.

How to install

  1. Enable developer mode for Google Chrome Extensions. See https://developer.chrome.com/extensions/faq#faq-dev-01

  2. Clone this repository to any location on your local computer.

  3. Use the "Load unpacked" option under Chrome Extensions to add this unpacked Chrome Extension to your browser. Pick the directory you checked this out to.

  4. A grayed out Drupal meeting parser icon will appear in your browser alongside the URL bar.

  5. Open the chatroom in Google Chrome. The icon will become blue and four bright yellow buttons should apear on the top of the page: Clear memory, Add with credit, Add without credit and To clipboard.

When to use

It is advised not to save the meeting log right after the meeting as the format itself allows remote participants to join slightly later. You should save the meeting logs a day or so later when the meeting text is still available but everybody had a chance to chime in.

How to use

The extension has internal storage for all your added threads. You can clear the internal storage with 'Clear memory', add a thread to it with 'Add with credits' or 'Add without credits' and copy the contents of that storage (all the threads you added in the order you added them) to the operating system's clipboard with the 'Copy to clipboard' button.

  1. Open each thread in the chat sidebar you want to add to the meeting notes. Click one of the 'Add' buttons once the sidebar appears. Repeat this for all threads you want to add to the notes. The script should scroll to the top of the thread first to autoload all items and then scroll to the bottom of the thread too until it loads all items from there as well.

  2. When done, click 'Copy X threads to clipboard'. Now your meeting notes are on the operating system clipboard and can be pasted into the Drupal meeting node for posterity.

  3. At the end of the paste, you will find a 'Participants' section. This includes chat usernames of participants for threads you added 'with credit'. It is a best practice to credit active meeting participants on the meeting notes issue. You can do that by pasting the list of participants at the end of your drupal.org meeting issue in the 'Credit others' textfield (in the 'Crediting & committing' fieldset). This field is only visible for maintainers of a project. If you are not a maintainer, ask a maintainer to credit people.

    Do keep in mind two things. First of all, it is a best practice to only credit active meeting participants. That is people who actually contributed to the meeting. You can use the 'Add without credit' button for introductory or off-topic threads you want to save without credits assigned. Second, drupal.org usernames will not always be the same as chat usernames. When you save credits after you pasted the list, check which users got credits and find and add the actual drupal.org usernames for the missing participants to credit. Then save them with another comment. Some common user name mappings are included with the script. We can add more, please submit them as issues at https://github.com/mdlutz24/drupal-meeting-parser/issues.

    Finally, don't forget to close the issue as fixed so the credits will be granted.

Contributing

All aspects of the extension can be improved, contributions welcome.