How documentation can lead to more alignmentHow documentation can lead to more alignmentHow documentation can lead to more alignmentHow documentation can lead to more alignment
    • Our Expertise
      • Increase Effectiveness
      • Align & Focus
      • Agile Leaders
      • Autonomous Teams
    • Our Offer
    • Our Achievements
    • Our Blog
    • About Us
      • Contact Us
    • 4 Pillars
    • Academy for Agile Coaches
    0

    0 ₫

    • Academy Login
    • This content is only for registered users.

    How documentation can lead to more alignment

    • Home
    • Insights
    • Agile Team Enablement Agile Delivery
    • How documentation can lead to more alignment
    Published by Chris Kruppa on May 13, 2021
    Documentation is necessary for improved alignment

    One big challenge for Agile practitioners is the general disregard of parts of the 4 values of the Agile Manifesto. Even, if it says literally: “That is, while there is value in the items on the right, we value the items on the left more.”

    This becomes probably most prevalent on the following value in the Manifesto:

    Working Software over comprehensive documentation

    Manifesto of Agile Software Development

    Working with many software companies (service or product) over the last 10 years, this is already a challenge; albeit this is a challenge, which we can fix quite straightforward. In Software development, documentation happens implicitly all the time: User Story Writing, In-Code Documentation or simple comments/messages in their commits and pull requests within the code repository are already simple forms of documentation. Software such as quod.ai even helps to automate that process using artificial intelligence.

    Developing Documentation in Non-IT organizations

    For non-software organizations, this value often becomes a relief. They already are busy and Agile often gives them the (wrong!) impression, that they even have to become faster. Cutting of documentation, therefore, will give back a lot of time to each individual contributor.

    semdi solutions as a small organization already made experience with lack of documentation of important agreements and processes. As an Agile organization, we believe strongly in self-organization and giving employees their power over their time. Nevertheless, there is a need for meetings, synchronizations or general awareness, what is going on. When initially hiring people, we at semdi solutions underestimated the fact.

    We are now at the next step of our growth journey. We invested a lot of time to develop documentation on our most important team agreements and processes. This should ease the onboarding process for any future newcomer. We now have documentation about the expectations on all job roles, most important team events and artifacts. Moreover, we described simple agreements on how we make decisions or resolve conflicts.

    Looking back at the Agile value, this seems as “over documentation” and yes, it took some initial efforts to create them. In the end, though, when we have interviews now, we can point them to clear expectations, agreements and generally, to how we want the company to work. It is only fair to our candidates and future colleagues to have a way of making sense of a new job environment.

    Start documenting your core values: the reason of your existence

    I bet that also you as an organization have a way to start this documentation process to ensure, that most of your team members are on the same page: Your core values. Nearly all organizations have core values and want to have them visible in the organization. But writing them on the wall or describing them in your confluence or website is mostly not enough. Values should be visible by inspiring actions within your team. A freshly onboarding newcomer should know immediately, how to behave. “Ownership” sounds like a nice value, but no newcomer understands, what you expect. Therefore, a list of behaviors for each value can help them to care about the company and do the right thing for your organization.

    If you document anything at all, start describing your values with a list of actions to set clear expectations to existing and new team members. This is important already in co-located organizations. But in a world, in which remote and working from home becomes more normal every day, this is even more important.

    Share
    Chris Kruppa
    Chris Kruppa
    Chris is a German working in Vietnam since 2008. He became passionate on Agile, when he started to implement Agile into his Marketing team about 2010. He immediately saw the impact of cross-functional and transparent teams and became a CSM in 2011. He founded semdi solutions in 2012 with the goal to coach teams on how to be more adaptive and ready for the 21st century. Since then, he has worked with nearly 20 organizations in Southeast Asia and supported them in increasingly becoming more Agile.

    Related posts

    What is Agile? True Agile is rarely visible in it's process
    January 5, 2023

    Agile: More than Just a Framework


    Read more
    Portrait Photo of Woman in Red Top Wearing Black Framed Eyeglasses Standing In Front of White Background Thinking
    December 13, 2022

    Making the most of Scrum: Avoid these Misconceptions


    Read more
    men and women having a meeting
    December 5, 2022

    Why You Need to be Agile


    Read more

    Leave a Reply Cancel reply

    Your email address will not be published. Required fields are marked *

    Logo semdi solutions

    semdi solutions Co. Ltd.

    Level 14, Saigon Center 1
    65 Le Loi
    Ward Bến Nghé, District 1
    Hồ Chí Minh City

     
    • Contact
    • Imprint
    • Privacy Policy
    semdi solutions, © 2022
      0

      0 ₫

      • Academy Login
      • This content is only for registered users.
      ✕

      Login

      Lost your password?

      We use cookies on our website to give you the most relevant experience by remembering your preferences and repeat visits. By clicking “Accept All”, you consent to the use of ALL the cookies. However, you may visit "Cookie Settings" to provide a controlled consent.
      Read More about our privacy policy
      Cookie SettingsAccept All
      Manage consent

      Privacy Overview

      This website uses cookies to improve your experience while you navigate through the website. Out of these, the cookies that are categorized as necessary are stored on your browser as they are essential for the working of basic functionalities of the website. We also use third-party cookies that help us analyze and understand how you use this website. These cookies will be stored in your browser only with your consent. You also have the option to opt-out of these cookies. But opting out of some of these cookies may affect your browsing experience.
      Necessary
      Always Enabled
      Necessary cookies are absolutely essential for the website to function properly. These cookies ensure basic functionalities and security features of the website, anonymously.
      CookieDurationDescription
      _GRECAPTCHA5 months 27 daysThis cookie is set by the Google recaptcha service to identify bots to protect the website against malicious spam attacks.
      cookielawinfo-checkbox-advertisement1 yearSet by the GDPR Cookie Consent plugin, this cookie is used to record the user consent for the cookies in the "Advertisement" category .
      cookielawinfo-checkbox-analytics11 monthsThis cookie is set by GDPR Cookie Consent plugin. The cookie is used to store the user consent for the cookies in the category "Analytics".
      cookielawinfo-checkbox-functional11 monthsThe cookie is set by GDPR cookie consent to record the user consent for the cookies in the category "Functional".
      cookielawinfo-checkbox-necessary11 monthsThis cookie is set by GDPR Cookie Consent plugin. The cookies is used to store the user consent for the cookies in the category "Necessary".
      cookielawinfo-checkbox-others11 monthsThis cookie is set by GDPR Cookie Consent plugin. The cookie is used to store the user consent for the cookies in the category "Other.
      cookielawinfo-checkbox-performance11 monthsThis cookie is set by GDPR Cookie Consent plugin. The cookie is used to store the user consent for the cookies in the category "Performance".
      viewed_cookie_policy11 monthsThe cookie is set by the GDPR Cookie Consent plugin and is used to store whether or not user has consented to the use of cookies. It does not store any personal data.
      Functional
      Functional cookies help to perform certain functionalities like sharing the content of the website on social media platforms, collect feedbacks, and other third-party features.
      CookieDurationDescription
      ppwp_wp_session30 minutesNo description
      Performance
      Performance cookies are used to understand and analyze the key performance indexes of the website which helps in delivering a better user experience for the visitors.
      Analytics
      Analytical cookies are used to understand how visitors interact with the website. These cookies help provide information on metrics the number of visitors, bounce rate, traffic source, etc.
      CookieDurationDescription
      _ga2 yearsThe _ga cookie, installed by Google Analytics, calculates visitor, session and campaign data and also keeps track of site usage for the site's analytics report. The cookie stores information anonymously and assigns a randomly generated number to recognize unique visitors.
      _ga_8T1CV8HV5N2 yearsThis cookie is installed by Google Analytics.
      _gat_gtag_UA_28003764_11 minuteSet by Google to distinguish users.
      _gcl_au3 monthsProvided by Google Tag Manager to experiment advertisement efficiency of websites using their services.
      _gid1 dayInstalled by Google Analytics, _gid cookie stores information on how visitors use a website, while also creating an analytics report of the website's performance. Some of the data that are collected include the number of visitors, their source, and the pages they visit anonymously.
      Advertisement
      Advertisement cookies are used to provide visitors with relevant ads and marketing campaigns. These cookies track visitors across websites and collect information to provide customized ads.
      CookieDurationDescription
      test_cookie15 minutesThe test_cookie is set by doubleclick.net and is used to determine if the user's browser supports cookies.
      Others
      Other uncategorized cookies are those that are being analyzed and have not been classified into a category as yet.
      SAVE & ACCEPT
      Powered by CookieYes Logo
      Pre-register for our 4 Pillars Guide

      "*" indicates required fields