DevOpsDay
      • 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
        • Owners
        • Signed-in users
        • Everyone
        Owners Signed-in users Everyone
      • Write
        • Owners
        • Signed-in users
        • Everyone
        Owners 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
    • 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 Help
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
Owners
  • Owners
  • Signed-in users
  • Everyone
Owners Signed-in users Everyone
Write
Owners
  • Owners
  • Signed-in users
  • Everyone
Owners 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
    # 團隊中如何使用文件/知識庫系統進行合作? ###### tags: `OST (I)` `9` `DevOpsDays Taipei 2018` `9/10` `OST` {%hackmd zjE8rohhTBKEAPwdaLV11Q %} * 有內部 wiki redmine * 由工程師寫文件 * 團隊了解不是很多查到資料會放在上面 * 不同產品線有不同的習慣 * Spec * Dropbox * Wiki * Google Doc * Mockup * Invision * QA * Spreadshhet * Office 365 * 導入敏捷後 * 不太寫文件 * 總公司的要求、需求管理 從需求的核准 * 用比較取巧的方式(工作流程管理) * 用線上看板當作需求文件 * 將文件 attch 到卡上面 * 會有自己的平台 + wiki / google * 工程師都不愛寫文件 * 跨部門溝通會有落差 * 跨部門溝通 * 用 Office 365 * 導入 SharePoint 大家都用 OneNote * 對跨單位的團隊,請工程師用對方的想法做白話的說明 * 做教育訓練 * 出問題還是要找工程師,不如請工程師多寫文件 * 會把 Known How 與 規格請工程師寫 * 至少商業邏輯會在上面 * Spec by example * 希望做到測試自動化 * 不知道怎麼寫 TestCase * 請 BA幫忙寫 * 只是各個部門中有 Known How 的人 * 把很多 Example 寫出來 * 可以反覆更動規格 * 導入自動化測試 * 與工程師做需求討論 * 做情境式的簡單腳本 * 再導入到 Jira * 寫 test code 花的時間比寫程式的時間多 * 希望在 CI/CD 做到 30% 的自動化測試 * 如何做測試 * 如果是 Cross Functional Team 比較容易辦到 * 找一天大家把文件 show 出來,如果有人看不懂就要修改 * 寫到讓大家都看的懂 * 很細的細節就 RD 之間懂就可以 * PO 講白話文 * PM 寫出 Spec * RD 寫成 Unit Test * QA 寫出 Test Plan * 下禮拜大家再來討論 * 導入 SPE 訓練大家寫 Sepc * 如何讓文件不會脫節 * 要有人把關 * 要有紀律 * 強制規定 / 讓事情爆發,再來彌補 * 團隊自主性很強,可以團隊成員把關 * 否則由 PM Leader / RD Leader 來把關 * 大家都知道文件很重要,單位會公司會不會給時間寫文件 * 產品要上線,很多很重要的事,文件都會被拖到最後 * 老闆如果重視文件,就會拉 Task 來寫文件 * 兩三個 sprint 上版後,再花半個 sprint 寫文件 * 等系統穩定再來寫 * 怎麼樣讓大家把知識拿出來,誰來驗證文件與環境是一樣的? * 很多人在做自動產生文件的功能 * 寫類似 psudo code (類似 markdown) 自動產生文件 * 古代 model-driven design * 完美的夢想 * 只有特定的流程可能 * 用流程把關 / 用人把關 * 用 code review / design review / peer review * 用 unit test * 對程式要有紀律,對文件才會有紀律 * 但程式是有產出的,可以 release ,但是文件呢? * 大型系統需要跟其他系統串接時,就可以看出文件很重要 * 沒有文件需要花很多時間來 reverse engineering * 要團隊成員有痛才知道文件的重要 * 有些企業會做輪調,現在做 coding ,之後做 PM * 有些想要專才,有些想要通才 * 專才就輪調到不同的產品線 * 通才可以換職位 * Art / Sciense * 藝術沒有對錯 * Sciense 就是事實 (fact) * 如果是 art 就很難自動化,成本就很高 * 沒辦法解決問題就解決提出問題的人 * 還是要看企業文化 * 團隊的價值觀要一致 * 讓成員去上一些課程 * 同儕去影響 * 不同的文化,不同的公司需要不同的流程 * 大家都是成熟的大人可能就不太需要流程 * 有些不成熟的大人,可能需要一些方法讓他改變,否則就是請他到別的地方另謀高就 * 否則 hire 一個新的人更快 * 雇用對的人很重要 * 用 code 產生文件不一致的問題 * 有些 IDE 會輔助 * 需求書 * 用類似 Markdown 的方式寫 * 有 parser 去從 code 裡面找出文件 * 用 checklsit 送 PR 的時候檢查文件是否更新 * Live document * 應用的領域還是很局限 * 大家都在開發自己的標準 * 把 Markdown conver 成 test code (SPE) * Wirting Great Spec. * 每個團隊都有自己的工具、自己的方法

    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