Release 10.1.0

• #584 Add support for adding comments to properties.
  The YamlMember attribute now has a Description property. When set, a comment is emitted when serializing that property:

  class Person
  {
      public string Name { get; set; }
  
      [YamlMember(Description = "This is the age")]
      public int Age { get; set; }
  
      [YamlMember(Description = "male or female")]
      public string Sex { get; set; }
  }

  Name: PandaTea
  # This is the age
  Age: 100
  # male or female
  Sex: male

Release 10.0.0

New features

• #592 adds the ability specify additional indentation for lists. By default, the emitter emits:

  list:
  - item1
  - item2
  

  By using this option, the emitter will output:

  list:
    - item1
    - item2
  

Bug fixes

• #598 Fixed AnchorNotFoundException if there is a reference to an anchor of a node which is being deserialized. This happens in cyclic references.

Other changes

• Breaking - Binary serialization support has been removed as there was no practical use-case for it.

• Refactor Portability.cs into conditionally included files to improve maintainability.
  There is now a set of directories under YamlDotNet/Helpers/Portability. Each directory's name contains a list of target platforms, separated by +. Each of those files is included only when building for one of those target platforms. Each directory may also contain a subsirectory named others. The files in this directory are included only when building for one target platform that is not in it's parent name.

• Make the type Nothing a ValueType
  There's no need for it to be a reference type.

• Use a custom type to represent anchor names
  This enables the compiler to detect when we pass something else
  where an anchor name is expected.

• Use a custom type to represent tag names
  This enables the compiler to detect when we pass something else
  where a tag name is expected.

• Release notes are no longer stored in the repository, because this forced a new meaningless commit to be created for each release.

Release 9.1.4

• Fix LookAheadBuffer trying to read from the stream after reaching its end

Release 9.1.3

• Fix an error when a stream returns less than the requested amount of bytes
  Fixes #560

Release 9.1.2

• Fix writePtr decrementation in InsertionQueue [#558]

This fixes another critical bug that was causing failures while parsing Yaml documents. If you are using release 9.1.1, please use this version instead.

Release 9.1.1

• Fix off by one error when resizing InsertionQueue

This fixes a critical bug that was causing failures while parsing Yaml documents. If you are using release 9.1.0, please use this version instead.

Release 9.1.0

Improvements

• Small performance improvements. Addresses [#519]
• [#490] Add anchor/alias support in JsonEventEmitter
• [#540] Allow block style in multiline scalars with trailing spaces
• [#482] Add support for private properties in the serializer.

Bugfixes

• Fix KeyNotFoundException in WithoutTypeInspector (fixes [#507])
• [#539] Fix deserialization for Nullable types.
• [#491] Disallow usage of alias before anchor declaration
• [#542] Fix the order of YamlMappingNode items
  YamlMappingNode will now return the items in the order they appear inside the document.

Release 8.1.2

Bug fixes

• Merge #483 - Allow values after DocumentStart token
• Merge #497 - Fix indentation check for first content line - fixes #492

Release 8.1.1

Bug fixes

• Improve compliance with the official YAML test suite: #467, #469 and #475.

• Make YamlMemberAttribute.DefaultValuesHandling actually usable. Fixes #466.

• Actually inherit YamlIgnore attributes: #481.

New features

• Add LowerCaseNamingConvention: #477.

Release 8.1.0

New features and improvements

• Made CachedTypeInspector thread safe #386
  Previously, using an instance of Serializer or Deserializer was not thread-safe,
  although the intention was for them to be thread safe. The only mutable state is
  inside CachedTypeInspector and was not properly protected against concurrent mutation.

Other fixes

• Fix type conflicts when targeting frameworks without nullability attributes #460