chriskelly
    • Create new note
    • Create a note from template
      • Sharing URL Link copied
      • /edit
      • View mode
        • Edit mode
        • View mode
        • Book mode
        • Slide mode
        Edit mode View mode Book mode Slide mode
      • Customize slides
      • Note Permission
      • Read
        • Only me
        • Signed-in users
        • Everyone
        Only me Signed-in users Everyone
      • Write
        • Only me
        • Signed-in users
        • Everyone
        Only me Signed-in users Everyone
      • Engagement control Commenting, Suggest edit, Emoji Reply
    • Invite by email
      Invitee

      This note has no invitees

    • Publish Note

      Share your work with the world Congratulations! 🎉 Your note is out in the world Publish Note

      Your note will be visible on your profile and discoverable by anyone.
      Your note is now live.
      This note is visible on your profile and discoverable online.
      Everyone on the web can find and read all notes of this public team.
      See published notes
      Unpublish note
      Please check the box to agree to the Community Guidelines.
      View profile
    • Commenting
      Permission
      Disabled Forbidden Owners Signed-in users Everyone
    • Enable
    • Permission
      • Forbidden
      • Owners
      • Signed-in users
      • Everyone
    • Suggest edit
      Permission
      Disabled Forbidden Owners Signed-in users Everyone
    • Enable
    • Permission
      • Forbidden
      • Owners
      • Signed-in users
    • Emoji Reply
    • Enable
    • Versions and GitHub Sync
    • Note settings
    • Note Insights
    • Engagement control
    • Transfer ownership
    • Delete this note
    • Save as template
    • Insert from template
    • Import from
      • Dropbox
      • Google Drive
      • Gist
      • Clipboard
    • Export to
      • Dropbox
      • Google Drive
      • Gist
    • Download
      • Markdown
      • HTML
      • Raw HTML
Menu Note settings Versions and GitHub Sync Note Insights Sharing URL Create Help
Create Create new note Create a note from template
Menu
Options
Engagement control Transfer ownership Delete this note
Import from
Dropbox Google Drive Gist Clipboard
Export to
Dropbox Google Drive Gist
Download
Markdown HTML Raw HTML
Back
Sharing URL Link copied
/edit
View mode
  • Edit mode
  • View mode
  • Book mode
  • Slide mode
Edit mode View mode Book mode Slide mode
Customize slides
Note Permission
Read
Only me
  • Only me
  • Signed-in users
  • Everyone
Only me Signed-in users Everyone
Write
Only me
  • Only me
  • Signed-in users
  • Everyone
Only me Signed-in users Everyone
Engagement control Commenting, Suggest edit, Emoji Reply
  • Invite by email
    Invitee

    This note has no invitees

  • Publish Note

    Share your work with the world Congratulations! 🎉 Your note is out in the world Publish Note

    Your note will be visible on your profile and discoverable by anyone.
    Your note is now live.
    This note is visible on your profile and discoverable online.
    Everyone on the web can find and read all notes of this public team.
    See published notes
    Unpublish note
    Please check the box to agree to the Community Guidelines.
    View profile
    Engagement control
    Commenting
    Permission
    Disabled Forbidden Owners Signed-in users Everyone
    Enable
    Permission
    • Forbidden
    • Owners
    • Signed-in users
    • Everyone
    Suggest edit
    Permission
    Disabled Forbidden Owners Signed-in users Everyone
    Enable
    Permission
    • Forbidden
    • Owners
    • Signed-in users
    Emoji Reply
    Enable
    Import from Dropbox Google Drive Gist Clipboard
       owned this note    owned this note      
    Published Linked with GitHub
    Subscribed
    • Any changes
      Be notified of any changes
    • Mention me
      Be notified of mention me
    • Unsubscribe
    Subscribe
    # Chairs: Best Practice Guidelines This guide is intended for anyone who regularly chairs calls at DIF. Please read it carefully: it outlines considerations for chairs while facilitating meetings, as well as guidance and tools to support a productive, transparent working environment across DIF. Reach out to [DIF directly](mailto:operations@identity.foundation) if you need any support or have any questions or concerns! ### [DIF Chair’s page of resources and tools](https://github.com/decentralized-identity/org/blob/master/chair_cheat_sheet.md) _This includes links to IPR and Membership agreements, WG charters, DIF Governance documents etc, DIF Brand guidelines and other useful resources._ --- ### ![](https://i.imgur.com/5WjytDD.png) **Pre-call checklist [most important]** --- 1. Prepare and share an Agenda for the call, ideally 24 hours in advance 2. Take notes (4-5 bullet points) to capture main topics 3. Make sure everyone on the call has signed the WG charter 4. Follow-up on agreed tasks 5. Your role, as chair, is to set and follow an agenda. Everyone should be equally represented and given a chance to speak 6. Plan to join TSC calls (as per TSC guidelines, 1 chair/WG minimum) --- ### ![](https://i.imgur.com/7cId82q.png) Before a Call --- * Prepare and share (email and/or Slack depending on group culture) an Agenda for the call, ideally 24 hours in advance * This can simply be a list of discussion points * It can include concrete items like GitHub pull requests (with links) * Consider adding estimates of time in mins for each agenda item * Invite group members to add items to the agenda * Double-check the meeting time in the public [DIF calendar](http://bit.ly/dif-calendar) * E.g. Daylight Saving Time affects meeting schedules differently on different continents * Send out an email reminder about the call to any guests or work item leads who are on the agenda. * A template for a content presentation is available [here](https://docs.google.com/presentation/d/1jXF5LhBLmKsbjCfGGBFNDC_tqISmgd8-DK-ISxSQkwc/edit#slide=id.g7760498cf3_0_50) * If a call has to be cancelled or postponed for whatever reason, give people as much advance notice as possible, and: * Send a message via email and Slack to the group * Reach out to Balazs or Chris to update the entry in the calendar * Clearly communicate when the next meeting will happen --- ### ![](https://i.imgur.com/vx8T4qO.png) Starting the Call --- * Arrive punctually to the call, allow 2-4 minutes for people to arrive * Greeting people as they arrive is a great opportunity to ensure everyone’s sound is working correctly as well as make them feel welcome * Welcome new faces and invite them to introduce themselves * Restate the IPR agreement, DIF Membership, WG Charter etc considerations * drop links in chat to these documents if there are new members or guests * Chairs should “claim host” in Zoom; this is needed to pause or stop the recording, eject bad-faith participants, or to enable screen-sharing for attendees. * Code for claiming host privileges is on the Chairs resource page linked above * All WG calls are automatically recorded to DIF’s zoom account. * If a member requests pausing the call, please inform them that since WG meetings are IPR protected the entire meeting must be on record. Suggest them to discuss their topic offline and find an alternative non WG meeting time to hear what they intend to share. If in doubt about IPR, please reach out to DIF operations. * Share the link to the Agenda [hackmd] document in the Zoom chat * Consider screen-sharing the Agenda document * Invite people again to add items onto the agenda for the call * An attendance list in the agenda document is not essential, but can be helpful * If needed, please ask the group for volunteers or support with note-taking --- ### ![](https://i.imgur.com/Qu26QlC.png) Notes --- * Notes are an important function of the calls and groups at DIF * **They allow group members to stay up-to-date even if they miss calls, and helps them decide whether and how much of the recordings to watch** * They provide context to the code being checked in and discussed on GitHub * Notes help the wider community follow progress of discussions and work items * The notes also form the basis for the DIF newsletter, an important channel for communicating about our work * They provide a history of conversations over time, important for IPR reasons * Please take notes in the agenda.md file on the group’s GitHub repo * Most groups prefer to keep a running agenda file with the most recent meeting at the top * Once an agenda file fills up, hackmd will disallow live editing; to “reset” the agenda.md file, move the contents to a new file using the naming convention “agenda-202X-Y.md” as needed. * Where feasible, the ideal notes include all major topics discussed and the range of differing viewpoints or approaches on major topics raised during the call * Full transcript of all comments is not needed, high-level bullet points are fine * if transcription- or W3C-style minutes get taken, these can be put into a collapsible section using <details><summary>{TITLE}</summary>{CONTENT}</details> HTML tags * Include relevant links where possible, including those posted in the Zoom Chat --- ### ![](https://i.imgur.com/ZNgQBZi.png) During a Call --- * Present the items as outlined on the agenda * Keep proceedings moving forward, be conscious of limited time * Maintain a professional, constructive tone within the group * Remember that many listeners who never show up to calls for timezone or other reasons may be listening * Set an expectation for when people can comment or ask questions * Using a queue format, ensure that everyone can speak in turn * The _raise hand_ feature of Zoom is useful to maintain a speakers’ queue * Keep an eye on comments and reactions in the chat * If time allows, open the floor to general discussion after material is covered * If material on the agenda is not dealt with, make it clear where that discussion will continue: asynchronous on GitHub, Slack or simply pushed to next meeting * If needed, set clear, actionable steps to be taken before the next call and agree who is responsible for them * If all content is covered before the allocated time, feel free to end the call early and give people time back * End the call with a reminder of when the next call will take place * As host, please end the recording, and use the Zoom ‘_End Meeting for All_’ button --- ### ![](https://i.imgur.com/UPywVkl.png) Post-Call follow-up --- * If someone assisted with note-taking, combine the notes from the call and review their notes * Paste in relevant comments and links from the Zoom chat * A quick scan of the notes for obvious errors and omissions * Spreadsheet of DIF call recordings is [here](http://bit.ly/DIF_recordings_list), divided by group * Recordings should appear shortly after the call, including the text chat * Record group decisions and further actions * Note the person responsible for the task * Setting a timeframe for the task is advisable * Include links, documents, contact names etc. needed for these steps --- ### ![](https://i.imgur.com/SxAB6i1.png) Asynchronous: GitHub, Slack --- * While calls are an important venue for work at DIF, plenty of work and conversations happen online via Slack, email and GitHub activity, and the same substantial-contribution/”IPR boundary” should be maintained across all channels * Chairs are responsible for maintaining the group mailing list & monitoring emails * Chairs are also expected to engage with and moderate the group work at GitHub and Slack, and also ensure compliance with the appropriate rules, IPR obligations, DIF code of conduct etc. * This extends to GH Discussions as well. As Discussions are created to host implementation related conversation, non-DIF members will also post there. There is a chance that such a post could include language/idea that might directly influence or qualify as a contribution to the IPR protected work item, in this case please follow these steps: * Comment on the point, warning that it may infringe or threaten IPR. Here is a template: ``` This comment has been removed as it might violate the Working Group's IPR. (Intellectual property rights) -- WG charter repo inc. IPR-- Please join DIF and the WG https://blog.identity.foundation/{WGname}/ to resubmit the comment as a PR on the repo. Thank you for your understanding. If you have any questions, please feel free to get in touch with me via email or DM. ``` * Remember to invite call attendees to join DIF Slack and WG channels * For IPR-protected technical working groups and work items, **all active attendees **need to be DIF members; if not, they should not contribute * For non-IPR-protected groups, any attendee can participate fully, with the understanding that any discussion topics that become work items of IPR-protected groups will require membership (i.e. it doesn’t hurt to often invite attendees to consider membership) * Keep an eye on GitHub pull requests, GitHub discussions and issues - “Watch all activity” function recommended * Stale PRs, threads, and entire repos should be marked as such and put explicitly on the agenda for “last call” consideration before archiving * Collate links to GH items as a list on the agenda for the next meeting is recommended * Be aware of IPR considerations, particularly for unknown or unidentifiable GitHub accounts that may not belong to members who have signed agreements at DIF --- ### ![](https://i.imgur.com/WW7ApKf.png) Procedural Considerations --- * Chairs shall be elected by the members of the group * No more than four chairs should serve at any one time. * Service shall be evaluated annually, with no maximum term. * Each Working Group is expected to send at least one chairperson to the monthly meetings of the Technical Steering Committee * More than one chair per WG may attend, however for TSC voting, each [IPR-protected] WG has one vote only. Chairs may of course confer among themselves about their vote. * Chairs are encouraged to use the #tsc-internal Slack channel to propose agenda items for the TSC wherever technical and procedural questions about chairship are a blocker to the WG’s productivity. * If a chair leaves their organization or their employer leaves DIF, a new Chair must be selected by consensus of the other co-chairs. The outgoing chair may not appoint a replacement unilaterally. It is up to the WG Chairs to pick a replacement chair, either by consensus or taking a vote, which should be announced and minuted as a public agenda item. --- ### ![](https://i.imgur.com/RZoVr4K.png) Group Care --- * Maintain a respectful, constructive atmosphere on calls, but also on GitHub writing, Slack channels etc. * DIF has a clear, inclusive [code of conduct](https://drive.google.com/file/d/1BRxGVPOXlLmFj_CzWSLroB1fcDekehv7/view): _We should strive to always be_ **_Welcoming, Empathetic & Thoughtful_** * Chairs are simply responsible for facilitating the conversation in the group, and their opinion does not hold more weight than any other member, nor should they dictate the course of conversation. * Consider: has everyone on a call had a chance to speak? Have pauses and sincere calls for opinion been observed for the quieter members, the guests, and the non-native speakers to feel comfortable speaking? * Attendees with no video tend to get noticed less and speak less * Mute anyone whose mic/background noise is creating a distraction: claim host privileges, and mute them from the participants list. * Consensus and agreement in the group is optimal, but cannot always be reached * Strong objections can and should be mentioned in the notes, but are not, per se, a reason to stop ongoing work * It is recommended that objections drive parallelized discussions and recurring agenda items to remediate while allowing other aspects of the work to continue * Consider how the group can embrace, grow and diversify its membership: * From the code of conduct - “_Diversity is never definitively out-of-scope or foreclosed as irrelevant to more urgent business”_. * _“[At DIF] we explicitly honour diversity in age, culture, ethnicity, genotype, gender identity or expression, language, national origin, neurotype, phenotype, political beliefs, profession, race, religion, dis/ability, sexual orientation, socioeconomic status, subculture and technical ability.”_ * Actively seek out a variety of differing viewpoints * Welcome a diversity of professional and personal backgrounds * Consider DIF membership from other timezones: the regular timing of a call can be changed after a consultation with and vote by attendees * Problematic behavior on a call should be stopped immediately and labelled inappropriate/unhelpful/not constructive. Feel free to refer group participants to the code of conduct * Discriminatory, insulting language, the use of sexualized language or imagery, sexual advances, offensive stereotypes or any other conduct which could reasonably be considered inappropriate in a professional setting have no place anywhere in DIF content, channels or calls * The DIF code of conduct contains a step-by-step conflict resolution process as well as further resources on principles and guidance * Consider how to best represent the interests of the group, wider membership, decentralized identity in general and DIF itself as an organization: * Discuss with DIF communication team about messaging: direct or public comms calls * Writing blog articles to highlight completed work, exciting news or developments, DIF comms is happy to offer editorial support * Attending and speaking at industry events * Considering partnerships with other orgs that have similar goals * Inviting relevant key speakers to present to the group * Presenting at a meeting is not an opportunity for a sales pitch to DIF membership; discussing a product is fine as long as it illustrates or illuminates a particular problem, technical solution, regional market etc * DIF Brand Guidelines for members and non-members are [here](https://www.notion.so/dif/f0b4ba442083499da6c1ffb67391bd02?v=d2aefb340cb8420f8ad7930c6a6c6ece) **Reach out to the DIF team directly if you need support, have any questions or concerns!** ## **Appendix 1**: [WG Chair Duties:](https://github.com/decentralized-identity/org/blob/master/chair_cheat_sheet.md) The responsibilities of a DIF Working Group chair include: * Ensuring compliance with all DIF rules applicable to the group. * Organizing the smooth operation of the group, scheduling and, where necessary, cancelling meetings. * Driving inclusivity, setting a positive and productive tone. * Identifying consensus within the group, and recording decisions & further actions. * Developing, communicating an agenda and leading the meetings. * Attendance lists are optional, but chairs should invite new members to introduce themselves to the group. * Notes: * Overseeing note-taking for the WG meetings * Notes are used to summarize the important topics and points discussed during the meetings, a full transcript is not necessary. * Notes are used by DIF for the Newsletter and for the All-hands meeting to update the broader community. * Notes are useful to discover historical meetings where certain topics were discussed. * Notes are often used by the wider community to follow progress on work items. * Notes also archive links, files etc. from the chat to make them accessible after the meeting. * Being a liaison between the group and all groups (both at DIF and externally) with which the group is coordinating. * Engaging with media, performing outreach, and ensuring the transparent operation of the group. * Sharing monthly updates for the DIF newsletter to inform the community * Engagement with activity on GitHub, responding to PRs and Issues. * Ensuring conformance with DIF's and the groups IPR agreements. * Send at least one chairperson to the monthly Technical Steering Committee meetings. --- ## **Appendix 2** *This document was last updated **23.11.2021*** *Feel free to leave us feedback or comments on this document, we are eager to learn and improve. Not all points will apply directly to every group or call. Contact us if you have questions about this document or more generally about DIF membership and work.* *Icons designed by Smashicons from [Flaticon](https://www.flaticon.com/authors/smashicons)*

    Import from clipboard

    Paste your markdown or webpage here...

    Advanced permission required

    Your current role can only read. Ask the system administrator to acquire write and comment permission.

    This team is disabled

    Sorry, this team is disabled. You can't edit this note.

    This note is locked

    Sorry, only owner can edit this note.

    Reach the limit

    Sorry, you've reached the max length this note can be.
    Please reduce the content or divide it to more notes, thank you!

    Import from Gist

    Import from Snippet

    or

    Export to Snippet

    Are you sure?

    Do you really want to delete this note?
    All users will lose their connection.

    Create a note from template

    Create a note from template

    Oops...
    This template has been removed or transferred.
    Upgrade
    All
    • All
    • Team
    No template.

    Create a template

    Upgrade

    Delete template

    Do you really want to delete this template?
    Turn this template into a regular note and keep its content, versions, and comments.

    This page need refresh

    You have an incompatible client version.
    Refresh to update.
    New version available!
    See releases notes here
    Refresh to enjoy new features.
    Your user state has changed.
    Refresh to load new user state.

    Sign in

    Forgot password

    or

    By clicking below, you agree to our terms of service.

    Sign in via Facebook Sign in via Twitter Sign in via GitHub Sign in via Dropbox Sign in with Wallet
    Wallet ( )
    Connect another wallet

    New to HackMD? Sign up

    Help

    • English
    • 中文
    • Français
    • Deutsch
    • 日本語
    • Español
    • Català
    • Ελληνικά
    • Português
    • italiano
    • Türkçe
    • Русский
    • Nederlands
    • hrvatski jezik
    • język polski
    • Українська
    • हिन्दी
    • svenska
    • Esperanto
    • dansk

    Documents

    Help & Tutorial

    How to use Book mode

    Slide Example

    API Docs

    Edit in VSCode

    Install browser extension

    Contacts

    Feedback

    Discord

    Send us email

    Resources

    Releases

    Pricing

    Blog

    Policy

    Terms

    Privacy

    Cheatsheet

    Syntax Example Reference
    # Header Header 基本排版
    - Unordered List
    • Unordered List
    1. Ordered List
    1. Ordered List
    - [ ] Todo List
    • Todo List
    > Blockquote
    Blockquote
    **Bold font** Bold font
    *Italics font* Italics font
    ~~Strikethrough~~ Strikethrough
    19^th^ 19th
    H~2~O H2O
    ++Inserted text++ Inserted text
    ==Marked text== Marked text
    [link text](https:// "title") Link
    ![image alt](https:// "title") Image
    `Code` Code 在筆記中貼入程式碼
    ```javascript
    var i = 0;
    ```
    var i = 0;
    :smile: :smile: Emoji list
    {%youtube youtube_id %} Externals
    $L^aT_eX$ LaTeX
    :::info
    This is a alert area.
    :::

    This is a alert area.

    Versions and GitHub Sync
    Get Full History Access

    • Edit version name
    • Delete

    revision author avatar     named on  

    More Less

    Note content is identical to the latest version.
    Compare
      Choose a version
      No search result
      Version not found
    Sign in to link this note to GitHub
    Learn more
    This note is not linked with GitHub
     

    Feedback

    Submission failed, please try again

    Thanks for your support.

    On a scale of 0-10, how likely is it that you would recommend HackMD to your friends, family or business associates?

    Please give us some advice and help us improve HackMD.

     

    Thanks for your feedback

    Remove version name

    Do you want to remove this version name and description?

    Transfer ownership

    Transfer to
      Warning: is a public team. If you transfer note to this team, everyone on the web can find and read this note.

        Link with GitHub

        Please authorize HackMD on GitHub
        • Please sign in to GitHub and install the HackMD app on your GitHub repo.
        • HackMD links with GitHub through a GitHub App. You can choose which repo to install our App.
        Learn more  Sign in to GitHub

        Push the note to GitHub Push to GitHub Pull a file from GitHub

          Authorize again
         

        Choose which file to push to

        Select repo
        Refresh Authorize more repos
        Select branch
        Select file
        Select branch
        Choose version(s) to push
        • Save a new version and push
        • Choose from existing versions
        Include title and tags
        Available push count

        Pull from GitHub

         
        File from GitHub
        File from HackMD

        GitHub Link Settings

        File linked

        Linked by
        File path
        Last synced branch
        Available push count

        Danger Zone

        Unlink
        You will no longer receive notification when GitHub file changes after unlink.

        Syncing

        Push failed

        Push successfully