贡献指南

Cromwell是一个开源项目,我们热忱欢迎社区为代码和文档做出贡献。以下是一些添加文档的指南,以及我们最需要帮助的领域建议。

首先,以下是一些有用的链接:

写作技巧

  1. 保持清晰、准确且简洁。
  2. 将最重要的信息放在首位。
  3. 使用第二人称,用“你”代替“用户”。
  4. 不使用被动语态(所有动作都有明确的执行者)。
  5. 链接到原始来源,不要重复文档内容。

格式化

文档采用Markdown格式编写。点击此处查看Github的Markdown指南,点击此处获取更多MkDocs使用技巧

样式设置

链接:

  • 绝对路径: [link text](www.destinationURL.com) 示例: [Broad Institute](www.broadinstitute.org) 会生成这个链接 Broad Institute.
  • 相对路径:[link text](Destination_Page),其中Destination_Page是不带.md扩展名的文件名
    示例: [How to use the Cromwell CLI](CommandLine) 会生成这个链接 How to use the Cromwell CLI
  • 锚点链接: [anchor text](../Path/To/Page#Anchor)
    示例: [HPC文件系统](backends/HPC#filesystems) 生成此链接 HPC filesystems.

代码:

  • 要为代码中的单词添加样式,请在单词前后使用反引号(`)。
    示例: `file.json` 会生成 file.json
  • 要格式化代码块,请在代码块前后使用三个反引号(```)。
    示例:
    ```
    workflow myWorkflow {
    call myTask
    }
    ```
    将生成如下代码块
    workflow myWorkflow {  
    call myTask  
    }  
  • 要使用语法高亮功能,请在开头的三个反引号(```)后指定语言。
    示例:
    ```json
    {
    "MyWorkflow.MyTask.VariableTwo": "Variable2"
    }
    ```
    会生成如下代码块
    {
        "MyWorkflow.MyTask.VariableTwo": "Variable2"
    }

镜像

  • Relative: ![](ImgName.png)
    • 示例: ![](../jamie_the_cromwell_pig.png) 生成此图片
  • Absolute: ![](URLofImg.png)
    • 示例: ![](https://www.broadinstitute.org/sites/all/themes/custom/at_broad/logo.png) 生成此图片

左侧菜单:

要在菜单中添加或删除项目,请编辑Cromwell中的mkdocs.yml

常见问题

为什么我的文档没有显示?