≪ View Page

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
pub:company:communications [25.09.2024 12:26] – removed - external edit (Unknown date) 127.0.0.1pub:company:communications [23.10.2024 10:29] (current) – [Writing and Design Style] Predrag Tasevski
Line 1: Line 1:
 +====== Communications ======
  
 +This page explains what every team member (//Unicians//) needs to know in order to effectively contribute at Unicis.
 +
 +===== All hands =====
 +
 +Unicis organizes a meeting called the “All hands” every month. All team members, both internal and external, are required to attend the monthly “All Hands” meeting. All meetings are recorded and team members who can’t attend should watch the recording within a few days.
 +
 +===== Strategy =====
 +
 +You can read about company positioning and product strategy in Unicis Strategy (private).
 +
 +===== Competition =====
 +
 +We monitor the capabilities of competitors and adjacent products on our [[https://www.unicis.tech/comparison|Comparison webpage]].
 +
 +===== Directly responsible individuals (DRIs) =====
 +
 +^Area of responsibility                  ^DRI                    ^
 +|Revenue                                 |Founder and Co-Founders|
 +|Pricing                                 |Founder and Co-Founders|
 +|Illustrations                           |Founder and Co-Founders|
 +|Website                                 |Founder and Co-Founders|
 +|Ads, Social media, Video                |CEO and CCO            |
 +|Information Technology (IT)             |CEO and CTO            |
 +|Legal contracts                         |CEO                    |
 +|Payroll, Bookkeeping                    |CEO                    |
 +|Customer support, renewals & deployments|CCO                    |
 +|Quality assurance (QA)                  |CEO and CTO            |
 +|Feature and product                     |Founder and Co-Founders|
 +|Product documentation                   |CEO                    |
 +|Engineering output and architecture     |CTO                    |
 +|Product development                     |CEO and CTO            |
 +|Invoicing                               |CEO                    |
 +
 +===== Website(unicis.tech) =====
 +
 +Unicis website is built with [[https://docusaurus.io|Docusaurus]]. Therefore, if you wish to make changes to the components, you will need access to the [[https://gitlab.com/unicis/website|private repository]].
 +
 +==== Docs ====
 +
 +The [[https://www.unicis.tech/docs/|technical documentation of Unicis]] is written in [[https://docusaurus.io/docs/2.x/docs-introduction|Markdown file]] in a hierarchical format and is generated using the [[https://docusaurus.io/docs/2.x/versioning|versioning CLI]] to generate a new documentation version.
 +
 +==== Blog ====
 +
 +Blog articles can be published using [[https://decapcms.org/|Decap CMS]] - an open source content management system, via following [[https://www.unicis.tech/admin/|link]].
 +
 +===== Marketing programs =====
 +
 +We only use open source marketing solutions, such as [[https://matomo.org/|Matamo]] for web analytics to track online visitors and [[https://www.mautic.org/|Mautic]] for marketing automation.
 +
 +==== Newsletter ====
 +
 +We use Mautic to communicate with our community and people who sign up for our newsletter. Use the Unicis template to make a [[https://www.mautic.org/blog/marketer/email-marketing-level-one|Mautic e-mail campaign]] and send it.
 +
 +{{tag>newsletter mautic}}
 +===== Unicis on Social Networks =====
 +
 +==== Social Media ====
 +
 +The biggest asset of Unicis is its user community. Social media conversations give contributors a chance to answer technical questions and get feedback.
 +
 +Unicis doesn’t focus on selling itself. Instead, conversations are already happening in our social spaces that allow Unicis to connect with the community.
 +
 +Here are some ideas for social media posts:
 +
 +  * Unicis the Product: Updates, new features, and user testimonials about Unicis.
 +  * Internal Progress: Highlight team achievements, milestones, and glimpses into our work.
 +  * Highlighting Community Contributions: Showcase the contributions of our users and celebrate their successes.
 +  * Highlighting Unicis and Industry Accomplishments: Share the major accomplishments and awards Unicis has received.
 +  * Industry News about Our Field: Share news and information about our products and services.
 +  * Upcoming Events, Interviews, and Podcasts: Promote upcoming events, webinars, interviews, and podcast appearances by - Unicis and its team members.
 +
 +^Platform      ^Hashtag/Account          ^
 +|X (ex-Twitter)|@UnicisTech              |
 +|Mastodon      |@unicis_tech@mastodon.xyz|
 +
 +==== Unicis on LinkedIn ====
 +
 +The [[https://www.linkedin.com/company/unicis-tech-o%C3%BC/|Unicis company page]] can be used to promote original posts on LinkedIn by Unicis staff. Follow these steps if you think your post would be effective in front of a larger audience:
 +
 +  - Create a Post note: Make a [[https://cloud.unicis.tech/apps/notes/|note on the Nextcloud]] and tag it with ''%%LinkedIn%%''.
 +  - Provide Context: Include any context in the note to explain why the post is important.
 +  - Await Approval: Please keep an eye out for approval. Your post will be reviewed by the team and used in a promoted post if it’s deemed appropriate.
 +
 +==== Ads ====
 +
 +Unicis employs advertising to disseminate information to a broader audience and encourage greater involvement within communities. The more people who actively use Unicis or contribute, the better Unicis will be.
 +
 +==== Events ====
 +
 +One of the most effective methods of promoting Unicis products and solutions is through participation in events. This presents an opportunity to directly engage with potential users and contributers, build partnership, relationship, gather feedback, and create a stronger sense of community and trust.
 +
 +==== Podcast ====
 +
 +Right now, Unicis doesn’t have a podcast, but we plan to do it in the future. We invite podcasters to invite us to participate in your sessions and promote Unicis and what we are building.
 +
 +==== Video ====
 +
 +Unicis uses [[https://vimeo.com/user183384852|Vimeo]] to keep the community informed about new products and demo videos. These videos provide community engagement, educational resources, and essential information about Unicis and the people who use it.
 +
 +===== Meetings =====
 +
 +  * **Join the meetings on time**. At Unicis, we start meetings promptly and don’t wait for late arrivals. Since we usually use the [[https://jitsi.unicis.tech/|Jitsi]] conferencing tool, make sure you join with a working microphone and camera. Being late for a few minutes can cause problems and make your meeting colleagues wait longer. When in doubt, try to join a few minutes early.
 +  * **Turn on your camera**. Enabling your camera makes communication more complete and easy. You are welcome to keep your camera on or turn it off when joining meetings with new participants you may not be familiar with yet. But make sure to turn on your camera when you lead or cohost a meeting or when you show off your work during a demonstration.
 +  * **Be warm**. The first minute or two of a meeting should be spent being present and engaging in small talk. Since we work remotely, we often miss out on the informal conversations and human connections that happen in physical workspaces. In the first minute of the meeting, say “Hi!” and connect before going over the agenda.
 +  * **Take notes**. Every meeting should have a [[communications|designated responsible person]] to ensure that:
 +    * The agenda is made or prepared in advance.
 +    * A designated notetaker is assigned to the meeting.
 +    * All action items are recorded and assigned to the right people.
 +
 +==== Meeting agendas ====
 +
 +<WRAP danger>**“No agenda, no attenda.”**\\
 +Every work-related meeting should have a calendar invite with an editable agenda.</WRAP>
 +
 +<WRAP info>**Unicis Meeting Agenda**\\
 +To create a meeting agenda please use one of the following options:</WRAP>
 +
 +
 +  * [[https://docs.nextcloud.com/server/latest/user_manual/en/groupware/calendar.html#create-a-new-event|Create a new event]] via [[https://cloud.unicis.tech/apps/calendar/|Nextcloud Calendar]]
 +  * [[https://www.openproject.org/docs/user-guide/meetings/|OpenProject meeting]] related to your project: - [[https://www.openproject.org/docs/user-guide/meetings/classic-meetings/|Classic meeting]]: allows you to manage and document your project meetings, prepare a meeting agenda together with your team and document and share minutes with attendees, all in one central place. - [[https://www.openproject.org/docs/user-guide/meetings/dynamic-meetings/|Dynamic meeting]]: allows you easier meeting management, improved agenda creation and the ability to link work packages to meetings and vice-versa.
 +  * 
 +==== External meeting scheduling ====
 +
 +When scheduling external meetings, please provide external participants with a link to the Unicis intranet applications to schedule with the relevant internal participants. See how to [[https://docs.nextcloud.com/server/latest/user_manual/en/groupware/calendar.html#appointments|configure public calendar appointments]].
 +
 +==== Internal meeting scheduling ====
 +
 +In order for the internal team to be able to schedule a meeting, it is important to set your [[https://docs.nextcloud.com/server/latest/user_manual/en/groupware/calendar.html#availability-working-hours|working hours]] in Unicis Intranet and [[https://docs.nextcloud.com/server/latest/user_manual/en/groupware/calendar.html#managing-your-calendars|block out any personal time/events]], so that the team members do not inadvertently schedule a time when you are not available.
 +
 +<WRAP info> **Hint** If the meeting is 1-to-1, you can use the [[https://chat.unicis.tech/element|Element]] call functionality. If the meeting is with more than one person, we suggest using [[https://jitsi.unicis.tech/|Jitsi]]. </WRAP>
 +
 +==== Modifying an event organized by someone else ====
 +
 +You can edit, duplicate or delete an calendar event by using the following [[https://docs.nextcloud.com/server/latest/user_manual/en/groupware/calendar.html#edit-duplicate-or-delete-an-event|steps]].
 +<WRAP warning > **Tip**\\
 +Only the calendar owner can send out invitations. The sharees are not able to do that, whether they have write access to the event’s calendar or not. </WRAP>
 +
 +==== Shared Calendars ====
 +
 +With Unicis Intranet - Nextcloud it is possible to [[https://docs.nextcloud.com/server/latest/user_manual/en/groupware/calendar.html#sharing-calendars|share calendars]].
 +
 +===== The Skip level One-on-One =====
 +
 +At Unicis, skip-level one-on-one meetings are designed to foster open communication, enhance transparency, and build stronger relationships between employees and senior leadership. These meetings provide an occasion for team members to discuss their experiences, provide feedback, and collaborate on company objectives directly with senior managers, bypassing their immediate supervisors.
 +
 +==== Jitsi ====
 +
 +We use Jitsi for online meetings at Unicis. It’s important that everyone on the team feels comfortable using it. The Jitsi settings are the same for all team members. Please read the [[https://jitsi.github.io/handbook/docs/category/user-guide|user guide]] for more information.
 +
 +<WRAP info> **Authentication Method**\\
 +Use SSO credentials to be a moderator and host a Jitsi meeting.</WRAP>
 +
 +Example:
 +
 +  * Username: ''%%[username]@jitsi.unicis.tech%%''
 +  * Password: ''%%[your Unicis SSO password]%%''
 +
 +==== Recording meetings ====
 +
 +Recording meetings at Unicis is an important practice that improves transparency, accountability, and continuity within the organization. It ensures that team members who can’t attend can access and review important discussions and decisions. At Unicis, we suggest to use [[https://obsproject.com/|OBS]] to record (e.g. browser window) our meetings and make these recordings available to the entire company. This is especially important for meetings with external participants, such as customers, prospects, or community members. Recording these meetings helps create great sales and customer success teams by giving them a reliable source of information and training. If a team member with recording privileges attends such meetings, they are in charge of recording the session and making sure that key information is kept and available for all relevant stakeholders.
 +
 +The video recording session should be uploaded to the [[https://cloud.unicis.tech/apps/files/files?dir=/Recordings|Recordings]] group folder in the [[:start|Unicis intranet]].
 +
 +<WRAP danger> **Important**\\
 +Before you begin recording the session, please inform everyone in the meeting. </WRAP>
 +
 +===== Information classification =====
 +
 +At Unicis, all information is classified according to the [[https://www.unicis.tech/security#data-classification|Security Policy]] and the categories define who can access the information.
 +
 +  * **Public**: Share with anyone, anywhere in the world
 +  * **Internal**: Share only with team members who’ve signed an NDA, consulting agreement, or employment agreement
 +  * **Confidential**: Share only with founders of Unicis, business operations, and/or the people involved. e.g., social security numbers during hiring
 +
 +===== Email relays =====
 +
 +At Unicis, several special email addresses automatically send messages to the right people, ensuring efficient communication and quick responses. Each email address has a minimum response time (“Min RT”) and a direct responsible individual (DRI) who is in charge of reading and responding to emails. This [[https://support.unicis.tech/|system (FreeScout)]] ensures that inquiries and issues are promptly addressed, thereby enhancing efficiency.
 +
 +===== Matrix/Element =====
 +
 +At Unicis, we don’t email each other inside the company. Instead, we use Element to talk to other Unicians.
 +
 +==== Key Matrix channels ====
 +
 +^Channel             ^Purpose                         ^
 +|''%%#tech%%''       |Tech and development topics.    |
 +|''%%#town-square%%''|Read company-wide announcements.|
 +|''%%#off-topic%%''  |Be random.                      |
 +
 +==== Matrix communications and best practices ====
 +
 +At Unicis, we use Element to communicate. We encourage the use of channels over direct messages and encourage the use of threads within the Element whenever possible. Threads help reduce noise and notifications for others who are following the channel. We also don’t use global tags in channels to keep the environment respectful. Employees are encouraged to post polls or inquiries in the relevant channel and mention their teammates.
 +
 +===== Discord =====
 +
 +We use [[https://discord.com/invite/8TwyeD97HD|Discord]] to connect with open-source community members and contributors.
 +
 +==== Key Discord channels ====
 +
 +^Channel                  ^Purpose                              ^
 +|''%%#general%%''         |General topics.                      |
 +|''%%#help-and-support%%''|Help and support for Unicis Products.|
 +|''%%#community%%''       |Engaging with community.             |
 +|''%%#announcements%%''   |Unicis annoucments topics.           |
 +
 +===== Source Code repositories =====
 +
 +For the product and documentation, we have two different sources of truth. [[https://gitlab.com/unicis|GitLab]] is used for private purposes and allows team members to interact, while [[https://github.com/UnicisTech/unicis-platform-ce|GitHub]] is public and allows community members to interact with Unicis.
 +
 +==== GitLab labels ====
 +
 +Unicis uses special characters or words to organize and categorize GitLab issues.
 +
 +^Label                  ^Description                           ^
 +|''%%bug%%''            |A defect in the product.              |
 +|''%%business - BE%%''  |Business Edition commercial feature.  |
 +|''%%community - CE%%'' |Community Edition open-source feature.|
 +|''%%feature%%''        |New feature in the product.           |
 +|''%%forge UI kit%%''   |Using Atlassian Forge UI Kit.         |
 +|''%%forge custom UI%%''|Using Atlassian Forge Custom UI Kit.  |
 +|''%%payment%%''        |Billing feature in the product.       |
 +|''%%premium%%''        |Premium feature in the product.       |
 +|''%%ultimate%%''       |Ultimate feature in the product.      |
 +|''%%subscription%%''   |Subscription feature in the product.  |
 +
 +==== GitHub labels ====
 +
 +^Label                   ^Description                                 ^
 +|''%%bug%%''             |A defect in the product.                    |
 +|''%%dependencies%%''    |Pull requests that update a dependency file.|
 +|''%%documentation%%''   |Improvements or additions to documentation. |
 +|''%%duplicate%%''       |This issue or pull request already exists.  |
 +|''%%enhancement%%''     |New feature or request.                     |
 +|''%%good first issue%%''|Good for newcomers.                         |
 +|''%%help wanted%%''     |Extra attention is needed.                  |
 +|''%%invalid%%''         |This doesn’t seem right.                    |
 +|''%%javascript%%''      |Further information is requested.           |
 +|''%%question%%''        |Subscription feature in the product.        |
 +|''%%wontfix%%''         |This will not be worked on.                 |
 +
 +
 +===== Spending company money =====
 +
 +At Unicis, spending company money follows a simple approach.
 +
 +  - **Responsible Spending:** As you would your own money, make wise decisions and avoid unnecessary expenses.
 +  - **Efficiency:** Just buy what you need to do your job well and quickly.
 +  - **Autonomy:** You can make purchases in the company’s interest without permission. It’s best to tell your manager as soon as possible if you’re not sure.
 +  - **Guidelines:** Refer to our company’s expense policy for more information about responsible spending practices.
 +
 +We make sure that company money is used responsibly and effectively to help us reach our goals at Unicis.
 +
 +===== Travel =====
 +
 +FIXME
 +
 +===== Vendor questionnaires =====
 +
 +In response to security questionnaires, Unicis strives to provide full transparency through our security policies, trust, and application security documentation. You may also want to refer to the [[trust_center:vendor_questionnaires|vendor questionnaires page]]. Contact the C-level to address any pending questions.
 +
 +===== Contract signature and approval =====
 +
 +To have the contract signed, you must request an approval in Unicis Intranet by [[https://docs.nextcloud.com/server/13/user_manual/files/access_webgui.html#tagging-files|tagging]] the document with ''%%signature%%'' tag.
 +
 +==== Contract Review ====
 +
 +The CEO must approve each contract. Only internal Unicians can ask for contract review. Each request for approval has the option of being accepted or rejected. The Intranet adds an ''%%approved%%'' or ''%%rejected%%'' tag to the document.
 +
 +==== Contract Signed ====
 +
 +We use an open source [[https://apps.nextcloud.com/apps/libresign|LibreSign]] Nextcloud app for document and contract signing.
 +
 +===== Trust center =====
 +
 +In a [[..:trust_center|Trust center]] we talk about the Security and Technical and Organisational Measures (TOMs) that we have implemented at Unicis for compliance requirements.
 +
 +===== Compensation and Benefits =====
 +
 +FIXME
 +
 +==== Time tracking ====
 +
 +We track how much time you spend on issues and merge requests as described in this [[https://docs.gitlab.com/ee/user/project/time_tracking.html|GitLab guide]].
 +
 +==== Invoicing ====
 +
 +Each invoice addresing to Unicis needs to include the below company details, otherwise it will be invalid.
 +
 +<WRAP danger> **Company Details**\\
 +Unicis.Tech OÜ
 +
 +Address: Sepapaja tn 6, 15551 Tallinn, Estonia
 +
 +Registry code:16566212.
 +
 +VAT number: EE102590489. </WRAP>
 +
 +<WRAP info> **Invoice Generator for Freelancer**\\
 +Please use the [[https://www.xolo.io/zz-en/free-invoice-generator/sales|free invoice generator]] from our Compliance, taxation, accounting, business expenses service provider Xolo.io. </WRAP>
 +
 +==== Benefits ====
 +
 +FIXME
 +
 +===== Team member onboarding =====
 +
 +Unicis is an open-source project, and anyone is welcome to contribute at any time. Before the start date for a core team member, they are welcome to contribute, but they are not expected to. Here are some recommendations for new team members:
 +
 +//We welcome to Unicis!//
 +
 +  - Read about the company.
 +  - Take the time to get trained
 +  - Get used to the tools.
 +  - Become immersed in the world of .
 +
 +===== Performance feedback =====
 +
 +At Unicis, we use a structured process to hold performance feedback sessions.
 +
 +  - **Scheduled Meetings:** Feedback sessions are held every six months.
 +  - **Preparation:** Managers and employees think about their successes and challenges.
 +  - **Two-Way Dialogue:** Feedback sessions involve a discussion where both parties share their thoughts.
 +  - **Setting Goals:** Managers and employees establish SMART objectives that align with company objectives and personal growth.
 +  - **Continuous Support:** Support is given to employees to help them reach their goals and address performance issues.
 +  - **Documentation:** Feedback discussions and objectives have been documented for future reference.
 +  - **Follow-Up:** Progress tracking and additional support are ensured through regular check-ins.
 +
 +This approach fosters a culture of continuous learning and growth at Unicis.
 +
 +===== Equipment =====
 +
 +Unicis currently does not provide company equipment or software licenses.
 +
 +===== Writing =====
 +
 +Learn how to communicate at Unicis, including guidelines for the tone of voice, our approach, grammar and mechanics, and more.
 +
 +==== Writing and Design Style ====
 +
 +**Writing** FIXME
 +
 +==== Design, Colour, Icons and Font ====
 +
 +
 +//Design//: FIXME
 +
 +//Color//:
 +<codify css>
 +color-primary: #0052cc;
 +color-primary-dark: #142b5f;
 +color-primary-darker: #0046ad;
 +color-primary-darkest: #00398f;
 +color-primary-light: #005ae0;
 +color-primary-lighter: #005eeb;
 +color-primary-lightest: #0a6dff;
 +code-font-size: 95%;
 +navbar-background-color: #0043a8;
 +navbar-link-color: #ffffff;
 +navbar-link-color-hover: #c5e9fb;
 +navbar-link-color-active: #bdbdbd;
 +navbar-link-background-color-active: #145cc4;
 +navbar-link-background-color: #043581;
 +dropdown-background-color: #3080ea;
 +footer-background-color: #142b5f;
 +heading-font-family: 'Esphimere';
 +menu-color: #d9faff;
 +button-background-color: #ebedf0;
 +</codify>
 +
 +//Font//: We use company wide font [[https://gitlab.com/unicis/website/-/tree/master/static/fonts?ref_type=heads|Esphimere]] or [[https://www.dafont.com/esphimere.font|dafont.com]].
 +
 +//Icons//: We use the following library [[https://www.npmjs.com/package/@iconify/react|@iconify/react]] and select ONLY the <wrap important>**"Commercial use is allowed"**</wrap> from [[https://icon-sets.iconify.design|iconify.design]].
 +
 +==== LanguageTool ====
 +
 +We use an open-source tool [[operations:tech_stack_applications|LanguageTool]] that checks grammar and style in company documents. Access and instructions for usage.
 +
 +==== Writing in Markdown and Frontmatter ====
 +
 +At Unicis, we use Markdown syntax and conventions. Here are some examples and a [[https://www.markdownguide.org/cheat-sheet/|Cheat Sheet]] for Markdown. We can also use [[https://mystmd.org/guide/frontmatter|Frontmatter]] to add metadata and options.
 +
 +===== Glossary =====
 +
 +Commonly used terms at Unicis.
 +
 +^Term^Meaning                                                                                                            ^
 +|API |(Application Programming Interface) a software go-between that allows applications to communicate.                 |
 +|DRI |Directly responsible individuals.                                                                                  |
 +|PR  |A pull request is a proposal to merge a set of changes from one branch into another.                               |
 +|GRC |Term covering an organization’s approach across these three practices: governance, risk management, and compliance.|
 +
 +{{tag>communication writing blog marketing tools chat video call recording colors time tracking benefits feedback repository source code}}