CHANGELOG

v20220503a

Content:

Removed Zoom meeting picture in the Remote Working page.
Documented our usage of SSPL licensed software.
Update to Team members.
Preparation for VSHN HackDay #3.

v20220427a

Content:

Introduce the Customer Solutions Advisor role.
Replace Solution Architect role from Sol with the new role in Customer Solution.
Introduce new Requirements Engineering and Solution Design replacing "Tech Pre-Sales" domain.
Add VSHN Delegate Circle Calendar as recommendation to add

v20220419a

Content:

Document VSHNeers Delegate Circle modus operandi.
Update VSHNeer Success Domain as a quick fix before an actual review.
Iteration over Vision and Key Drivers to focus more on Cloud Native and narrow the focus.
Cleanup beliefs to remove old content.
Initial version of VSHN Key Deliverables. The "good enough and safe enough to proceed with this" version.

v20220411a

Content:

Update Management Members.
Update team membership and PeopleOps responsibility.
Clarifications in Personal Workplace Budget.
Small wording changes in Trial Period.
Added a page which describes the rules how to work with contractors.
Document our password manager Passbolt.
Add list of tools maintained by Corporate IT.
Added page about the definition of "VSHNary".

v20220408a

Infrastructure:

Complete overhaul of CI/CD Pipeline See Contributing for how to contribute to the Handbook.

The version numbering now follows vYYYYMMDD[a-z] and features a corresponding Git Tag.

2022–04–01: Version 3.6

Content:

Updated Vision and Key Drivers.

2022–03–31: Version 3.5

Content:

Add Debt Collection Register and Criminal Records
Update Outside Office Hours definitions in Timetracking.
Update COVID-19 rules to reflect end of regulations after April 1st, 2022.

Infrastructure:

Add check for ordered lists using correct ASCIIDOC style (and not markdown)

2022–03–23: Version 3.4

Content:

Updated diagram in the values page.
Added clarification about lunch breaks and how to record them in timesheets.
Integrate Corporate Services Strategy as constraints for Corporate IT.
Move overview of Teams at VSHN including team member names into handbook from wiki.
Add Sick Leave documentation

2022–02–17: Version 3.3.1

Content:

Update COVID-19 rules with common sense statements

2022–02–17: Version 3.3

Content:

Update COVID-19 rules according to the February 16 Federal Council press release.

2022–02–02: Version 3.2

Content:

Update COVID-19 Rules according to Feb 2nd FOPH press statement.

2022–01–31: Version 3.1

Content:

Added the sales process including responsibilities and Roles.
Fix link to on-boarding page in Wiki.
Rename Product Management Workgroup to Products Workgroup.
Replace Solutions Delegate Circle with Customer Solutions Workgroup.
Document Corporate IT Workgroup.

Infrastructure:

Migrated website to Antora 3.0.0 and latest Asciidoctor version.
Migrated from APPUiO Public to APPUiO Cloud.

2022–01–17: Version 3.0

Content:

Replace Product Bets with Product Roadmap (and update all references to it)
Completely rewrite Company Alignment.
Restructure navigation around the domains of VSHN.
Complete rewrite of VSHNeer Roles overview page.
Complete rewrite of Teams overview page and related content.
Update and consolidate Marketing & Sales domains.
Simplify and update Delegate Circles.
Simplify and update Domains explanations.

2021–12–22: Version 2.20

Content:

Update Domain Customer Solutions to point to miro board, remove outdated content.
Update Domain Products to point to miro board, remove outdated content.
Update Domain Product Development to point to miro board, remove outdated content.
Update Domains Overview.

2021–12–17: Version 2.19

Content:

Update Jira issue types and sub pages.
Update COVID-19 Rules according to Dec 17th FOPH press statement.

Infrastructure:

Updated Antora UI bundle to latest version.

2021–12–03: Version 2.18

Content:

Update COVID-19 Rules according to Dec 3rd FOPH press statement.

2021–11–29: Version 2.17

Content:

Align Communication Channels email classification with ISMS policy.
Change to stricter COVID-19 Rules for the office.
Add clarification about "Halbtax" in Salary System
Document responsibility for risks in Partner Management.
Update Emergency Communication Channels with info who should be informed internally.
Update Recruiting Process to add steps to comply with ISO 27001 A.7.1.1

2021–11–05: Version 2.16

Content:

Update Office Management how to handle broken stuff.
Updated COVID-19 Rules.

2021–11–02: Version 2.15

Content:

Update Weekly Company Meeting.
Exception for Meeting Schedule for the Weekly Company Meeting.

2021–10–29: Version 2.14

Content:

Add role Business Development Manager.
Add Harmonized Meeting Schedule and adapt the Meetings page.

Infrastructure:

Add meta description and keywords to each page.

2021–10–22: Version 2.13

Infrastructure:

Enable most tests again under useful conditions.

2021–10–21: Version 2.12

Infrastructure:

Support preview deployments of branches with GitLab CI.
Change CI to run tests and validations for master and the develop branch only.

2021–10–19: Version 2.11

Content:

Add On-Call page.
Updated Technical Pre-Sales domain after a short review.
Link to our BYOD Policy in Personal Hardware Budget
Add link to office plan in Miro.
Add note about holiday increase in Salary System (VIP-140).
Add trust to values.
Update terminology.
remove mentions of "APPUiO public" and "Products delegate circle"

2021–09–20: Version 2.10

Content:

Updated VSHN HackDay page.

2021–09–10: Version 2.9

Content:

Add Developer Relations role.
Add new page about the VSHNday to company alignment.
Iterate on VSHN values, refactor Beliefs and Goals on separate pages, and fixing links.
Make titles on Timetracking directly linkable.

Infrastructure:

Update VSHN Antora template.
Webserver configured to deliver compressed HTML/CSS/JavaScript.
Add testing of source (trailing whitespace/newlines) and HTML (check presence of analytics, and meta tags).
Update Vale text style checker.

2021–08–30: Version 2.8

Content:

Add Chief Marketing Officer role.
New Product Management domain and Work Group.
Decommission the Products Delegate Circle.

2021–08–18: Version 2.7

Content:

Introduce new People Care domain.
Add Recruiting Principles to Recruiting.
Update Recruiting Process for our new Freshteam tooling.

2021–08–16: Version 2.6

Content:

Information Security Management domain is a work group not an interest group
Added square logos in the Brand Guide page.
Introduce the new 24/7 Operations domain and Work Group.

2021–07–30: Version 2.5

Content:

Documented personal education (VIP-141) and updated all links which pointed to the old page.
Documented licensing guidelines for code we write.

Infrastructure:

Removed support for generating Kindle-only "MOBI" files.
Removed warnings during HTML checks in build pipelines.

2021–07–27: Version 2.4

Content:

Review and overhaul of Organizational Development.
Various fixed and changes to all Delegate Circles relating to new Organizational Development.
Update Weekly Company Meeting to VIP-108.

2021–07–27: Version 2.3

Content:

New Brand Guide page.
Review and complete overhaul of Central Services.
Add duty for Delegates to read VIP before meetings.
New structure and overview of Teams and other Circles.
- Introducing new circle type "work group."

2021–07–16: Version 2.2

Content:

New domain Partner Management.
New role Partner Manager.
Fix wording and to whom to report CISO Role.
Improvements to the Holiday checklist.

2021–07–08: Version 2.1

Content:

Clarify who can order a headset in Personal Hardware Budget.
Added section numbers to Information Security Process.
Added Development Security Policy.
Ensure North Star Goals are respected in CISO Role.
Rewriting of some sections in the Governance Meeting page.
Refinement (simplification) of Two Year Goals 2021 & 2022.

2021–06–25: Version 2.0.4

Content:

Fixed index entries in the e-book versions.
Clarifications to COVID-19 Rules.
Updated COVID-19 Rules starting June 26th 2021.

2021–06–17: Version 2.0.3

Content:

Added page about Retrospectives.
Added page about Personal Coaching.
Added page about Learning and Reflection.
Edited and expanded page about One-on-one Meetings.

2021–06–15: Version 2.0.2

Content:

Updated terminology for floaty.

Infrastructure:

Updated UI bundle with bug fixes.

2021–06–15: Version 2.0.1

Content:

Updated VSHN HackDay page.

2021–06–15: Version 2.0.0

Content:

New page about Personal Hardware Budget.
New page about Personal Workplace Budget.

Infrastructure:

Updated UI bundle matching the new look and feel of the vshn.ch website.

2021–06–14: Version 1.42

Content:

New page for the Solution Architect Role.
New pages for the Marketing and Sales domains.

2021–06–08: Version 1.41

Content:

New page with Fringe Benefits.
Fixes and improvements to the Recruiting Process.
Updated COVID-19 Rules.

2021–06–07: Version 1.40

Content:

Small updates in Information Security Process caused by yearly review
Update Information Security Management to document responsibility shift from Management to Board
Updated COVID-19 Rules.

2021–05–28: Version 1.39

Content:

New Recruiting domain and process.
Rename Timesheets to Timetracking and track it as a VIP.

2021–05–11: Version 1.38

Content:

Clarify time logging for managed service related work in Timesheets.
Add role description for Product Manager.
Update role description of Product Owner.
Update domain description of domain Product Management.
Add Inside Sales role description

2021–05–04: Version 1.37

Content:

Document Technical Pre-Sales.

2021–05–03: Version 1.36

Content:

Add credits to Henrik Kniberg for our Alignment Framework.
Add new role description for Corporate IT Lead.

2021–04–26: Version 1.35

Content:

Remove Legal & Compliance from Management Members.

2021–04–15: Version 1.34

Content:

Add link to wiki to find Zoom rooms in Emergency Communication Channels
Updated Recruiting Process page.
Updated areas of responsibility for Customer Success Managers and Service Managers.
New page to promote the VSHN HackDay.
Our technology focus is documented now in Company Beliefs.
Adapted the product portfolio according to the enhanced Company Beliefs.
Document the role of the Facilitator.

2021–04–06: Version 1.33

Content:

Update of the Service Manager Role.
Document the role of the Agile Coach.

2021–03–26: Version 1.32

Content:

Small updates to Product Bets.
Document list of available managed services in the product portfolio.
Update Onboarding process and duties of the Mentor in Trial period and Role of the Mentor.

2021–03–12: Version 1.31

Content:

Document Corporate Services Strategy as per VIP-78.
More accurate specification of the 15 minute response time goal on the Responsible Ops role page.
Complete rework of "The VSHN Offering" into the product portfolio.
Add duty of "offering help to other teams" to Responsible Ops, as agreed in VIP-73.
Small adjustments to salary system to describe the process to apply for education budget.

2021–03–05: Version 1.30

Content:

Document that Civil (Protection) Service is the same as Military for Leave Requests.
Restructure and clean-up Timesheets.
Add Militia Fire Service rules to Timesheets.
Replace Antares with PeopleOps in some places.
Improvements on how we can handle Tensions.
Various fixes and better definitions on the Responsible Ops role page.
Rewrite the per issue/alert section of Responsible Ops.

2021–03–01: Version 1.29

Content:

Remove obsolete page about Governance vs Operations
Replace VSHN Improvement Process by VSHN Improvement Proposals.
Complete overhaul of how we use Sociocracy 3.0 with new overview page Evolving our Organization.

2021–02–19: Version 1.28

Content:

Change of Delegate from the Management Members for VSHNeers Delegate Circle
Rename and update the Central Services Domain (formerly Backoffice)
Remove Kaus from Teams and change Polaris and Sirius to Solution Team. Other minor changes to the Teams page

2021–02–05: Version 1.27.4

Infrastructure:

Enhanced visitor experience with better "404" error page.
Added new automated testing of redirection to renamed pages.
Updated antora/preview container version.
Updated Antora UI bundle.

2021–02–01: Version 1.27.3

Content:

Renamed page describing "Management" role to Management Member.
Added "Role Keepers" section in Management Member chapter.

2021–01–19: Version 1.27.2

Infrastructure:

Added redirection from old squads.html page to the new teams.html page.
Added support for custom 404.html page.

2021–01–19: Version 1.27.1

Infrastructure:

Added support for OpenSearch.

2021–01–14: Version 1.27

Content:

Update SARS-CoV-2 / COVID-19 with new home office obligation and added SECO poster.

2021–01–04: Version 1.26

Content:

Documented Time-Tracking rules from VIP-17 in Timesheets page.
- Remove information to log to (generic) Chores on various pages.
Updated Salary System to reflect the agreement made in VIP-27.
Removed documentation finder, this is now in the knowledge base.
Updated documentation about documentation to include hints about Documentation as Code.

2020–12–14: Version 1.25

Content:

Add clarification on the differences between People Operations and VSHNeers Success
Add pictures that illustrate Delegates in Delegate Circles.
Document our Company Alignment Framework.
Adapt Values, Beliefs and Goals by linking to and from Company Alignment.

2020–11–30: Version 1.24

Content:

Link domain descriptions to VIPs in Jira
Document Review Driver state in VSHN Improvement Proposals
Fix links in CISO Role
Document Role of the Delegate for Delegate Circles
Improve description of what Delegate Circles are.
Minor fixes to the role General Manager.
Fix that General Manager(s) appoint the management, not the Board.
Fix granting power of attorney to be in the duties of the General Manager.
Document the roles Representative of the Board and Representative of the Management.

2020–11–23: Version 1.23.1

Fix typos in CHANGELOG
Rename top-level VSHNeer Success back to Life before VSHN again in navigation
Fix Domains to link to Information Security Management

2020–11–23: Version 1.23

Content:

Fixes to the VSHN Improvement Proposals
Add description of the role General Manager
Improve CISO Role
Update Information Security Management Domain
Add translated Information Security Process as sub page of Information Security Management Domain
Document domain Backoffice
Document domain People Operations
Document domain VSHNeer Success
Fixes on responsibilities in the Recruiting process
Document difference between Governance and Operations
Document common modus operandi for Delegate Circles
Add important links to Responsible Ops role description

2020–11–16: Version 1.22

Content:

Replace Altair references from Emergency Communication Channels and Team Admin
Document Product Bets
Document domain Information Security Management

2020–10–30: Version 1.21

Content:

Fix squad / chapters in Decision Making
Document VSHN Improvement Proposals including How-Tos
Initial version of our North Star and 2-year goals on Values, Beliefs and Goals
Document definition of Domains are current Domains
Add Kaus Team
Rename Role Squad Master to Team Admin
Get rid of the terms Squad and Chapter

2020–10–29: Version 1.20

Content:

Add Organizational Development domain description
Document how we make decisions in Special Circles like Board and Management.
Document Product Management Interest Groups
Update SARS-CoV-2 / COVID-19 after new rules from Federal Council effective since October 28, 2020.

2020–10–26: Version 1.19

Structure:

New navigation structure.

Content:

Add VSHN Domain description.
Add Business Operations Domain description.
Add Customer Solutions Domain description.
Add Product Management Domain description.
Add Product Development Domain description.
Remove Squads and Chapters
Add overview of Teams
Add overview of Delegate Circles
Add overview of Special Circles
Add documentation about Interest Groups
Update Organization Structure
Add links to Teams wiki pages
Improve documentation on what a Team is

2020–10–20: Version 1.18.1

Content:

Small corrections after release 1.18.

2020–10–20: Version 1.18

Content:

Update SARS-CoV-2 / COVID-19 after new rules from Federal Council effective since October 19, 2020, including meeting room usage.
Remove references to dissolved squad Capella.
Added page with the Sales On–Boarding Process.
Smaller corrections.

2020–10–15: Version 1.17

Content:

Change SARS-CoV-2 / COVID-19 related rules after "Stage Orange" was announced

2020–10–13: Version 1.16

Content:

Added page describing The VSHN Offering
Adapt and simplify Consent Decision Making process.
Adapt documentation after Altair is dissolved.

2020–10–05: Version 1.15

Content:

Renamed our weekly team meeting as "Company Meeting."
Added page explaining how our one on one meetings work.
Be true about who is failing (not the processes, but the people).
Added guidelines for those returning from holidays.

2020–09–04: Version 1.14

Content:

Updated communication channels and links to describe our discussion forum. The communication channels page now features a TL;DR section for a quick overview.
Added new page describing Emergency Communication Channels.
Update Company Values and Beliefs formerly "Vision, Mission, Values"
Updated Jira ticket numbers.
Corrections for small typing mistakes.

Infrastructure:

Updated to latest version of Antora Default UI.

2020–07–16: Version 1.13

Content:

Added page with instructions about the Zoom phone system.
Added page with tips and tricks to answer phone calls.
Added new page with the list of meeting rooms.
Document final decision in recruiting process.
Fix how members of the management are appointed.
Rename human resources to PeopleOps.

2020–06–22: Version 1.12.1

Typos fixed in SARS-CoV-2 / COVID-19

2020–06–22: Version 1.12

Content:

Add list of popular shared calendars to calendar.
Update the Sirius Squad mission statement.
New page that describes how we work in the office.
Adapt Meeting culture and other changes in favor of working remotely.
Document the base of our organizational structure.
- Split management board and the management member role.
- Document that VSHN implements Sociocracy 3.0 patterns and concepts where it makes sense.
Document how we make organizational decisions.
Updates to Customer Success Manager role.
Refinement of weekly company meeting.
Small wording changes in your first day.
Updated information about SARS-CoV-2 / COVID-19 after regulation relaxing.

2020–06–08: Version 1.11

Content:

New pages documenting Altair Squad.
Adapt duties of the Squadmaster to the Altair concept.
Update FOPH recommendations.

2020–06–03: Version 1.10

Content:

New page about the languages spoken in VSHN.
Updated information about SARS-CoV-2 / COVID-19.
Updated project states and roles.
A lot of small corrections and improvements.

Infrastructure:

Added automatic spell checking and dead link checking for authors.

2020–04–30: Version 1.9

Content:

Added Video conference tools usage guidelines.
Added new page about the CISO role.
Added documentation finder page.
Additions and corrections to the trial period page.
Updated guidelines regarding the SARS-CoV-2 / COVID-19 situation.
Small corrections and improvements.

Infrastructure:

Added liveness and readiness probes to OpenShift deployment.
Updated project to latest version of Antora and other tools.

2020–04–09: Version 1.8.1

Small fixes.

2020–04–09: Version 1.8

Content:

Added a "Values, Vision and Mission" page.
Renamed "Customer Success Hero" to "Customer Success Manager."
Updated links to tickets used for internal bookkeeping.
Other small modifications.

2020–03–16: Version 1.7.1

Content:

Updated the SARS-CoV-2 / COVID-19 page.
Updated the remote working page.
Added section on TUI tools and fixed confusion about git log and git reflog in the Git Guidelines page.

2020–03–16: Version 1.7

Content:

Added new page about SARS-CoV-2 / COVID-19 handling at VSHN.
Added new page about remote working
Added Git Guidelines chapter.
Updated Mail configuration settings.

2020–03–03: Version 1.6

Content:

Added information about leave requests.
Added new page describing the role of HR.
Added new page about the Personal Education Process.
Updated Jira blocking rules.
Various small corrections.

Infrastructure:

Added support for text-based diagrams using Kroki.
Updated project to latest version of Antora and plugins.
Updated project to latest version of PDF and EPUB generator images.

2020–01–27: Version 1.5

Content:

Added information about the new "Altair" and "Eltanin" squads.
New page with the complete list of chat channels.
New page about the Technical Service Manager role.
New page about the conflict resolution process.
Updated Jira links.
Various small corrections.

Infrastructure:

New navigation.
Updated Antora UI bundle.
Updated search engine.

2019–12–20: Version 1.4

Content:

Added Communication Channels page.
Added a roles introduction page.
Added the role of management.
Improved the description of the role of mentor.
Improved the description of the role of product owner.
Renamed role Customer Relationship Manager (CRM) to Customer Success Manager (CSH).
Refined squad documentation.
Added Martelo to the list of tools.
Various small corrections.

Infrastructure:

Updated PDF and EPUB3 generation to latest versions of Asciidoctor.
EPUB3 file displays custom font.

2019–11–20: Version 1.3

Content:

Reorganized navigation menu.
New content for the GitLab page.
New page with meeting rules.
New pages with explanations of the different roles.
New page about the trial period.
Explanation about how to pronounce the word "VSHN."
Updated squad descriptions.
Correction of various errata and typos.

Infrastructure:

Built using Antora 2.2.
Separated PDF and EPUB build procedure into separate projects.

2019–10–09: Version 1.2

Content:

Added the "Reverse Interview" page.
Added the "Work Logs" page.
Replaced "Götti" with "Mentor" throughout the handbook.

Infrastructure:

Added Asciidoc processing macros to the Antora playbook.
Added GDPR disclaimer, links, and Google Analytics tracking to generated website.
Added STEM support for PDF, EPUB, and Kindle output.

2019–10–01: Version 1.1

Content:

Added "Salary System" page.
Added precisions about when to close timesheets.
Added CHANGELOG.
Updated UI bundle to support STEM content.
Lots of small corrections and additions.

Infrastructure:

Reorganized Dockerfiles in subfolders.
Added verification using the vale tool.

2019–07–25: Version 1.0

First publicly available version.

Content:

Added "Everyday Life" page.
Added "Recruiting" page.
Added "Timesheets" page.
Added GPG-related pages.
Easier download of eBook versions.
Added man page output to eBook formats.
Corrected typos and rephrased various items.

Infrastructure:

Updated UI bundle.
Deployment to APPUiO via CI/CD at handbook.vshn.ch/
Unified all build tasks to use Docker containers exclusively.
Added search engine.
Separated Lunr.js indexing into separate project.

2019–06–07: Version 0.5

Interim version during development.
Preliminary migration of content from the wiki.