diff --git a/docs/BOSS Metadata Syntax.html b/docs/BOSS Metadata Syntax.html index 97dd4b86..cd15ac74 100644 --- a/docs/BOSS Metadata Syntax.html +++ b/docs/BOSS Metadata Syntax.html @@ -108,7 +108,7 @@ h3{
  • BOSS's support for YAML syntax is incomplete. A list of known limitations can be found here. The only major missing piece is support for merge keys (<<:).
  • Child data nodes should be indented two spaces from their parents. This isn't a strict requirement, but is the best trade-off between compactness and readability.
  • Strings are case-sensitive, apart from file paths, regular expressions and checksums. -
  • Strings should be enclosed in single quotes if they contain any of the following characters: -?:,[]{}#&*!|>"%@`, unless they also contain any single quotes, in which case the string should be enclosed in double quotes instead. This isn't always strictly necessary, but it's better to err on the side of caution. If you really want to only quote strings when absolutely necessary, be sure to check what you write by copy/pasting the whole data structure the string appears into a YAML parser such as this one and making sure that what it outputs is correct. +
  • Strings should be enclosed in single quotes if they contain any of the following characters: -?:,[]{}#&*!|>"%@`, unless they also contain any single quotes, in which case the string should be enclosed in double quotes instead. This isn't always strictly necessary, but it's better to err on the side of caution. If you really want to only quote strings when absolutely necessary, be sure to check what you write by copy/pasting the whole data structure the string appears into a YAML parser such as this one and making sure that what it outputs is correct.
  • In a double-quoted string, any backslashes and double quotes (excluding those quoting the whole string) need to be escaped with a backlash, ie. "\" and \\\. It's best to avoid using backslashes (except for the purpose of escaping) wherever possible, due to its double meaning. In file paths, a forwardslash can be used instead.

    For example, the following condition nodes are all equivalent:

    -

    Please test any changes you make before uploading them. One way of doing this is to run BOSS, another is to copy/paste what you've changed into an online parser such as this one, though it won't catch condition syntax errors or non-syntax errors such as having the same file both required and incompatible. +

    Please test any changes you make before uploading them. One way of doing this is to run BOSS, another is to copy/paste what you've changed into an online parser such as this one, though it won't catch condition syntax errors or non-syntax errors such as having the same file both required and incompatible.

    Metadata File Contents

    The root of a metadata file is a key-value map. BOSS will recognise the following keys, none of which are required: