One-Among.Us Memorial Site Editing Guide
Project Structure
One-Among.Us is a fully open source website. The source code and articles are stored mainly in the three GitHub repositories: data
, web
, and backend
. If you want to contribute only to the content of the website, you can simply focus on the data
repo.
If you want to leave a comment, simply use the forms in the website.
Principles of Writing
We aim to be a small memorial rather than a wiki. Therefore, we encourage you to write to mourn those transgender friends or allies who have passed away, and to soothe those who are still alive. No matter what gender identity they were, we hope to show our readers, “they were the same as me. They are one among us.” Therefore, both overly exaggerated or overly calm descriptions need to be avoided.
You have more creative freedom than contributing to a wiki, but you should still follow some fundamental principles, such as:
- Be as truthful as possible.
- For large paragraphs of quotations, the source needs to be indicated.
- Slangs in the community can be used, but if you like, please add a comment when they first appear.
The article should be written in third person. Please use proper gender pronouns in accordance with the wishes of them. For non-binary, agender or gender-non-confirming people, if they did not show their pronouns, please use “they” in English and「ta」in Chinese for there is no proper, common Chinese characters at present. Or you can use your language skills to avoid pronouns.
Use proper punctuations in articles. In Chinese articles, regardless of different Chinese variants, use「」(outer) and『』(inner) for quotation marks in replace of “” or ‘’ unless the words in the quotation marks are not Chinese. Use curly quotation marks instead of straight ones.
If referring to outside resources, use web archive services such as Internet Archive and archive.today (see data/#141).
To protect our readers, if someone departed from us through suicide, please hide the detail of their methods as you can. You must not write down the name or dose of the medicine or drugs if it was an overdose or poisoning. You may also refer to Preventing suicide: a resource for media professionals by World Health Organization (Chinese version also available), if applicable.
To respect the privacy of the departed, unless we get specific authorization before they leave, we should not connect their different internet identities (just pick the most public one) or publish messages they have posted on private or anonymous SNS platforms.
Contribute with GitHub
Before proceeding, you may assure yourself that you have knowledge of:
- basics of
git
: cloning repositories, making commits, rebasing a branch to the main branch, and syncing between upstream and local repositories; - basics of GitHub: forking repositories, creating pull requests, and collaborate with other GitHub users;
- basic grammar of the YAML language: indentation rules, usage of dash, spaces, and quotes, and escaping from special characters;
- basic grammar of the Markdown language.
Otherwise, you can simply email your writings and advices to info [at] one-among [dot] us
. Our staff will transform them to the proper format. We do not assume our contributors have to master any technical skills – at any time, you can work in a more “traditional” way and your contribution will also be highly recognized.
Under construction