<commit_before>// Mixin and Function Documentation
// ================================


/// Prose Commentary
/// ================
/// Herman allows you to write "prose" markdown blocks,
/// to help introduce groups,
/// or add narrative flow between documented items.
/// @group samples
/// @name a


// Herman Sample
// -------------
/// This is a sample function.
/// You can actually put much more text in here,
/// and include markdown.
/// Lorem markdownum rapite neque loquentis pro inque; nullaque [triones
/// promisistis](http://duabuset-tandem.com/denos) quaque. Non iura oves creatas
/// mixta gente torum Caune. Huius sacra *corpora refert celeberrima* luctus tibi
/// cornua, nec qui [illum poteram](http://puta-elementa.com/vocequoque), et eundi
/// recalfecit efficiens isdem superi. Alii virginibusque vultus certa socios venae
/// ferrove finis longave, pignus duros nubifer!
///
/// - Tenuatus percussae tanta iudice Hippolytus miseram inmunis
/// - Ture Iovis holus est et vere
/// - Domus cum quid meae erras
/// - Quam apta fata puppis ergo solis praeteriti
///
/// @group samples
/// @see {function} sample-alias
/// @link http://oddbird.net OddBird Home Page
/// @todo Create more samples like this one
/// @todo Add more todo items
/// @author [<NAME>](http://oddbird.net/birds/#bird-miriam)
/// @since 1.0.0-alpha.1 Adding samples files to the documentation.
/// @param {number} $one -
///   The first parameter is required, because no default is given
/// @param {number} $two [$one] -
///   Our second parameter defaults to the value of our first one
/// @param {string} $three ['three'] -
///   Looks like this one takes a string instead
/// @returns {list} All three of the arguments in order
/// @example scss - describe examples if you want…
///   .example::before {
///     content: herman-sample(1, 2);
///   }
@function herman-sample(
  $one,
  $two: $one,
  $three: 'three'
) {
  @if (not $one) or (not $two) or (not $three) {
    @error 'Please provide values for all three parameters';
  }

  @return $one $two $three;
}


/// Extra Commentary
/// ================
/// Prose blocks can also include examples, and other annotations.
/// Documented items are sorted alphabetically in the output,
/// but you can move prose blocks by changing the `@name` annotation,
/// which will not be displayed.
/// @name herman-sample+
/// @example scss
///   @import 'samples/variables';
///   .private::after {
///     content: $private;
///   }
/// @link http://sassdoc.com/annotations/
/// @group samples


// Sample Alias
// ------------
/// This is a sample function alias.
/// @group samples
/// @alias herman-sample
/// @deprecated I don't think this alias is useful anymore
@function sample-alias(
  $one,
  $two: $one,
  $three: 'three'
) {
  @return herman-sample($one, $two, $three);
}


// Sample Alias Two
// ----------------
/// This is a sample function alias.
/// @group samples
/// @alias herman-sample
/// @deprecated Doesn't seem to work without a message
@function sample-alias-two(
  $one,
  $two: $one,
  $three: 'three'
) {
  @return herman-sample($one, $two, $three);
}


// Mixin with Content
// ------------------
/// Mixins can optionally accept a @content block,
/// passed in brackets. This example creates
/// a generated element `:before` the element it is used on.
/// @group samples
/// @param {String} $content -
///   A value for the `content` property
/// @param {arglist} $list… -<commit_msg>more playing with prose ordering<commit_after>// Mixin and Function Documentation
// ================================


/// Prose Commentary
/// ================
/// Herman allows you to write "prose" markdown blocks,
/// to help introduce groups,
/// or add narrative flow between documented items.
/// @group samples


// Herman Sample
// -------------
/// This is a sample function.
/// You can actually put much more text in here,
/// and include markdown.
/// Lorem markdownum rapite neque loquentis pro inque; nullaque [triones
/// promisistis](http://duabuset-tandem.com/denos) quaque. Non iura oves creatas
/// mixta gente torum Caune. Huius sacra *corpora refert celeberrima* luctus tibi
/// cornua, nec qui [illum poteram](http://puta-elementa.com/vocequoque), et eundi
/// recalfecit efficiens isdem superi. Alii virginibusque vultus certa socios venae
/// ferrove finis longave, pignus duros nubifer!
///
/// - Tenuatus percussae tanta iudice Hippolytus miseram inmunis
/// - Ture Iovis holus est et vere
/// - Domus cum quid meae erras
/// - Quam apta fata puppis ergo solis praeteriti
///
/// @group samples
/// @see {function} sample-alias
/// @link http://oddbird.net OddBird Home Page
/// @todo Create more samples like this one
/// @todo Add more todo items
/// @author [<NAME>](http://oddbird.net/birds/#bird-miriam)
/// @since 1.0.0-alpha.1 Adding samples files to the documentation.
/// @param {number} $one -
///   The first parameter is required, because no default is given
/// @param {number} $two [$one] -
///   Our second parameter defaults to the value of our first one
/// @param {string} $three ['three'] -
///   Looks like this one takes a string instead
/// @returns {list} All three of the arguments in order
/// @example scss - describe examples if you want…
///   .example::before {
///     content: herman-sample(1, 2);
///   }
@function herman-sample(
  $one,
  $two: $one,
  $three: 'three'
) {
  @if (not $one) or (not $two) or (not $three) {
    @error 'Please provide values for all three parameters';
  }

  @return $one $two $three;
}


// Sample Alias
// ------------
/// This is a sample function alias.
/// @group samples
/// @alias herman-sample
/// @deprecated I don't think this alias is useful anymore
@function sample-alias(
  $one,
  $two: $one,
  $three: 'three'
) {
  @return herman-sample($one, $two, $three);
}


// Sample Alias Two
// ----------------
/// This is a sample function alias.
/// @group samples
/// @alias herman-sample
/// @deprecated Doesn't seem to work without a message
@function sample-alias-two(
  $one,
  $two: $one,
  $three: 'three'
) {
  @return herman-sample($one, $two, $three);
}


/// Extra Commentary
/// ================
/// Prose blocks can also include examples, and other annotations.
/// @example scss
///   @import 'samples/variables';
///   .private::after {
///     content: $private;
///   }
/// @link http://sassdoc.com/annotations/
/// @group samples


// Mixin with Content
// ------------------
/// Mixins can optionally accept a @content block,
/// passed in brackets. This example creates
/// a generated element `:before` the element it is used on.
/// @group samples
/// @param {String} $content -
///   A value for the `content` property
/// @param {arglist} $list… -
{'fraction_non_alphanumeric': 0.18245353159851302, 'fraction_numerical': 0.0017843866171003717, 'mean_word_length': 2.722191477587161, 'pattern_counts': {'":': 0, '<': 5, '<?xml version=': 0, '>': 5, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '2538090', 'n_tokens_mistral': 2120, 'n_tokens_neox': 2055, 'n_words': 766}