Contributing to Martialis
Corrections, additions, sources, and new lineage data are all welcome. There are two ways to send them, and they are not equal.
The main route: the database Discussions
The Martialis Database Discussions are the most direct way to suggest something to the database itself. That is where entries are discussed, sources are weighed, and changes are decided, in the open. Discussions about an entry also appear on that entry's page here.
- Put the entry's ULID in the discussion title: that is how the discussion is linked to the entry.
- Discussions are public, so consider that when you write.
- You need a GitHub account.
- You can write in any language I can translate: when discussing someone from Germany, German is perfectly acceptable.
See the database's CONTRIBUTING.md for the details.
The suggestion form
The form on this site, here and at the end of each entry, is a convenience for those who do not use GitHub or prefer not to post in public. Suggestions are sent privately to the maintainer, reviewed by hand, and never published automatically. If you can use the Discussions, prefer them: what is written there can be read, answered, and built on by others.
The form needs a free account (see why sign in).
What a good suggestion looks like
- Say which entry it is about, and what should change.
- Every claim cites at least one source, with a locator and a direct quotation where the wording matters.
- Disagreeing sources are included, not left out.
What belongs in Martialis
Martialis records the core tree of martial knowledge transmission, its trunk and branches, not every practitioner. The author of this project, for example, has no entry. This is not a judgement of anyone's rank or skill: every entry must rest on evidence that someone other than the person can check.
A person, style or organisation can be added when at least one of these is true:
- Independent coverage: an encyclopedia with its own inclusion policy, such as Wikipedia in any language, has an article on them.
- A published source names them in a meaningful role: as a teacher, student, founder, or holder of a title or licence. A passing mention, or a source written by the person themselves, is not enough on its own.
- They are a link in the tree: they taught people who are in the database, or they connect an existing entry to its teacher, and a source shows it.
Teaching classes, running a club or holding a grade does not qualify by itself. If none of the points applies to you, create a profile and name your teachers from the database: that is the intended place for personal lineage, and it needs no source. Your teacher, or their teacher, may be missing and may qualify, and filling in the line above you is one of the most useful suggestions there is.
The full criteria are in the database's CONTRIBUTING.md.
Living persons
Disagreeing with an entry usually means disagreeing with a cited source. That leads to a conflicting source being added next to it, not to removal. People recorded in the database can ask for changes such as corrected dates or a better photograph, at the maintainer's discretion. Rights over personal data are separate and are described in the privacy policy.
Licensing
Anything you submit, in a Discussion, an issue, or the suggestion form, is dedicated to the public domain under CC0-1.0. See Contributions in the licensing terms.