MtF-wiki/content/zh-cn/docs/contributor-guide.md

83 lines
3.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

---
title: 贡献者指南
---
贡献方式:
1. 会 GitHub 操作,直接 <abbr title="Pull Request">PR</abbr> 或 通过 {{< shields/github-issue "mtf-wiki/MtF-wiki" >}}(该方法的过程将是公开的,请注意处理隐私数据,如果不会处理隐私数据,请通过邮件方式贡献内容)
1. 发送邮件到 <hi@mtf.wiki>
1. 在 [TransLand](https://chat.transland.lgbt) 发布主题
{{< notice info "友情提醒" >}}
绝对不要做出任何道德绑架的行为!!!
{{< /notice >}}
## HRT/诊断证明 {#proof}
### 撰稿要素
1. 医生姓名
1. 所在医院
1. 出诊时刻
1. 挂号方法
1. 问诊细节
1. 注意事项
### 撰稿原则
1. 您对于医生的印象/属性 tag「一次过」、「可与家长沟通」 等)可能不会第一时间更新在医生页面上,我们需要进行多方求证(来自不同来源/时期的报告)。
1. 对于需要标注 「跨性别友好」 的医生,我们需要进行多方求证(来自不同来源/时期的报告)。
1. 在编写内容时请遵循 **「未常态化、无普遍性则不提及」** 的原则,尽量不要在贡献内容中提及不具有时效性(长期有效)或存在特殊情况的内容,尽量确保严谨性,但此类情况可以在贡献时注释。
1. 问诊细节原则上需要清晰、明确的表述,如果对方愿意开具比较详细的病历请务必要求开具相关病历。并且可随医生信息一同上传其开具的病历(图片)以供参考。
1. 由于科室不同,开具诊断证明的医生没有权利开具 HRT 处方,开具 HRT 处方的医生没有权利开具诊断证明,这是基本常识。望贡献者在撰写医生介绍的时候切记。
1. 假如某位医生信息被编入 wiki 后表示自己不愿意被公开信息,我们将遵从其主观意愿将有关词条删除并列入过时名单。
## SRS {#srs}
## 报告新的 SRS 医生
1. 医生姓名
1. 所在医院
1. 如何预约
1. 手术前置要求
1. 手术技术(医生描述,第三方介绍,发表论文)
1. 有无实例(如医生提供近期案例,朋友、自己接受手术)
### 手术评价、术后效果
见:[手术评价方法]({{< ref "srs-compraise" >}})
## 关于附加资源
### 图片处理
如果图片为对纸质材料的拍摄,请使用 Microsoft Lens (fbk Office Lens) 进行处理以便于提供更好的阅读体验,当然,如果有条件的话建议提供扫描件。
照片中的 [Exif](https://zh.wikipedia.org/wiki/Exif) 信息可能包含设备型号、拍摄时间和地理位置等信息。建议您在上传前[移除敏感信息](https://commons.wikimedia.org/wiki/Commons:Exif#Editing_Exif_fields)。
如果您不会相关的后处理,可以将该图片提交至 <hi@mtf.wiki> 由我们脱敏后进行上传。
[Microsoft Lens (Android)](https://coolapk.com/apk/com.microsoft.office.officelens)
[Microsoft Lens (iOS)](https://apps.apple.com/app/id975925059)
[Microsoft Lens (Windows)](https://www.microsoft.com/en-us/p/office-lens/9wzdncrfj3t8)
### 附件目录
根据规范,不同种类附件都有存放目录,建议将附件存放至规范的目录下。
- 图片类附件建议建议存放至 [`/static/images/`][images] 目录下,在正文中使用 `/images/+路径` 的方式引用;
- PDF 等文档类附件建议存放至 [`/static/documents/`][documents] 目录下,在正文中使用 `/documents/+路径` 的方式引用;
[images]: https://github.com/mtf-wiki/MtF-wiki/tree/master/static/images/
[documents]: https://github.com/mtf-wiki/MtF-wiki/tree/master/static/documents/
### 表格
表格类说明建议使用内嵌 [CSV](https://zh.wikipedia.org/wiki/CSV) 格式
<!-- markdownlint-disable-next-line -->
````
```csv
表头1,表头2,表头3
内容,内容,内容
```
````