Each meeting should have an agenda and it should be shared prior to the meeting, ideally in the calendar item and/or invitation. This allows potential participants to prepare and decide whether attendance is required. Any participant can add items to the agenda. Prefix your item with your name or initials to communicate who's going to talk and lead the discussion. Adding new items to the agenda while the meeting is started is good practice and can be leveraged to keep the currently discussed item focused.
Video meetings should be conducted with cameras on whenever possible. Video helps provide meaningful context to synchronous communication and makes understanding accents easier.
During the meeting
Meetings start on time by the person with the first item on the agenda, verbalize and discuss the item. Once done, hand over to the owner of the next agenda item.
During the meeting, notes should be taken in an inline fashion. Non-participants can then read the agenda after the meeting and are up-to-date without having to scroll to a notes section.
Managers should meet at least weekly with each team member. The team member will be responsible for preparing the agenda with focus on goal setting and reporting. The objective of 1:1 meetings is to:
- Clarify objectives and goals
- Resolve priority for conflicting items
- Communicate anything the team member requires to be successful.
- Raise awareness about issues that threaten progress
Slack is the primary platform that we use for day-to-day conversation internally. We want Slack conversation to reproduce the kind of open communication that happens naturally in the real world. This kind of conversation benefits from the 'watercooler effect' which encourages others to join and to naturally broaden the conversation into a learning process. There are three principles to strive for:
Share Be comfortable over-answering a question. More is better! Don't just answer a question. Instead, provide context, explanation, links, pictures or anything else that makes the answer memorable. Assume that if someone is asking a question, they've already done some minimal research. Be respectful of the question and try to understand why it's being asked.
In Groups Avoid 1:1 conversations and communicate in shared groups for all normal conversation. Shared groups invite unusual perspectives and benefit everyone. Use private conversations only when privacy is truly needed.
Use Threads Prefer to keep discussions in threads. Threads are essential in Slack and provide several benefits. First, they reduce scroll back, and focuses channels. With threads, it is easier for someone to catch up on the conversation and selectively ignore conversations that they are not interested in. Threads also reduce notification noise. If the main conversation occurs in the top-level channel, everyone gets a notification for every message back and forth. By contrast, if the main conversation occurs in a thread, everyone gets a notification when the thread is created but will get no more notifications unless they are participating in the thread.
Note that information in Slack is ephemeral, it should not be used as a system of record for important information. All workspace, private, public, and direct messages are automatically deleted after 90 days. As such knowledge on a decision made in Slack, or elsewhere, should always be recorded in the GitHub issue, Google Document, or represented in this handbook.
Not all channels are joined by default when you join Slack. We've added a bunch below so you get to decide if you want more channels or not.
#handbook post a note here if updating a handbook page
Blog content release plan
The Ondsel blog is the primary place where we publish our vision, plans, ideas, and questions for the community. After publishing, we try to be strategic with sharing our content via social media. For general content, we publish in the following places. Posts should be published where it makes the most sense. Our intent is to be helpful and constructive with our content, not just spamming every available outlet.
/r/freecad subreddit has an active and engaged base of FreeCAD users. We often get good engagement and constructive feedback. Content here should be strictly FreeCAD related, not general Ondsel information.
Facebook has several FreeCAD related communities. All blog posts should be published on the Ondsel page. Share those posts to groups as it makes sense. Two groups of note are the main FreeCAD group and the FreeCAD Power Users group.
Share all blog posts from the @ondsel account
FreeCAD related content can be shared on the FreeCAD forum. Posts should be made in the most appropriate forum section. For general FreeCAD related content, The open discussion section is probably the most appropriate
All posts can be made to the Ondsel page. FreeCAD related content can be posted/shared to FreeCAD Group There is also a page for the FreeCAD Project Association. Only FPA relevatant content should be posted/shared here.
FreeCAD Project #general section https://discord.gg/tQ5KBvsF
YouTube is a particularly powerful platform. Content here should be carefully constructed with a focus on long life-time and relevance. It's very important to properly tag videos and to create engaging thumbnails.