docs: update README with C API documentation

---
type: pre_push_report
description: Results of running various checks prior to pushing changes.
report:
  - task: run_javascript_examples
    status: na
  - task: run_c_examples
    status: na
  - task: run_cpp_examples
    status: na
  - task: run_javascript_readme_examples
    status: na
  - task: run_c_benchmarks
    status: na
  - task: run_cpp_benchmarks
    status: na
  - task: run_fortran_benchmarks
    status: na
  - task: run_javascript_benchmarks
    status: na
  - task: run_julia_benchmarks
    status: na
  - task: run_python_benchmarks
    status: na
  - task: run_r_benchmarks
    status: na
  - task: run_javascript_tests
    status: na
---

Author: anandkaranubc

lib/node_modules/@stdlib/stats/base/dists/hypergeometric/pmf/README.md

@@ -157,6 +157,111 @@ for ( i = 0; i < 10; i++ ) {
 
 <!-- /.examples -->
 
+<!-- C interface documentation. -->
+
+* * *
+
+<section class="c">
+
+## C APIs
+
+<!-- Section to include introductory text. Make sure to keep an empty line after the intro `section` element and another before the `/section` close. -->
+
+<section class="intro">
+
+</section>
+
+<!-- /.intro -->
+
+<!-- C usage documentation. -->
+
+<section class="usage">
+
+### Usage
+
+```c
+#include "stdlib/stats/base/dists/hypergeometric/pmf.h"
+```
+
+#### stdlib_base_dists_hypergeometric_pmf( x, N, K, n )
+
+Evaluates the probability mass function (PMF) for a hypergeometric distribution with population size `N`, subpopulation size `K`, and number of draws `n`.
+
+```c
+double out = stdlib_base_dists_hypergeometric_stdev( 16, 11, 4 );
+// returns ~0.829
+```
+
+The function accepts the following arguments:
+
+-   **x**: `[in] double` input value.
+-   **N**: `[in] double` population size.
+-   **K**: `[in] double` subpopulation size.
+-   **n**: `[in] double` number of draws.
+
+```c
+double stdlib_base_dists_hypergeometric_pmf ( const double x, const double N, const double K, const double n );
+```
+
+</section>
+
+<!-- /.usage -->
+
+<!-- C API usage notes. Make sure to keep an empty line after the `section` element and another before the `/section` close. -->
+
+<section class="notes">
+
+</section>
+
+<!-- /.notes -->
+
+<!-- C API usage examples. -->
+
+<section class="examples">
+
+### Examples
+
+```c
+#include "stdlib/stats/base/dists/hypergeometric/pmf.h"
+#include "stdlib/math/base/special/round.h"
+#include <stdlib.h>
+#include <stdio.h>
+
+static double random_uniform( const double min, const double max ) {
+    double v = (double)rand() / ( (double)RAND_MAX + 1.0 );
+    return min + ( v*(max-min) );
+}
+
+int main( void ) {
+    double N;
+    double K;
+    double n;
+    double x;
+    double pmf;
+    int i;
+
+    for ( i = 0; i < 10; i++ ) {
+        N = stdlib_base_round(random_uniform(1.0, 20.0));
+        K = stdlib_base_round(random_uniform(0.0, N));
+        n = stdlib_base_round(random_uniform(0.0, N));
+        x = stdlib_base_round(random_uniform(0.0, n));
+        pmf = stdlib_base_dists_hypergeometric_pmf( x, N, K, n );
+
+        printf( "N: %lf, K: %lf, n: %lf, x: %lf, PMF: %lf\n", N, K, n, x, pmf );
+    }
+
+    return 0;
+}
+```
+
+</section>
+
+<!-- /.examples -->
+
+</section>
+
+<!-- /.c -->
+
 <!-- Section for related `stdlib` packages. Do not manually edit this section, as it is automatically populated. -->
 
 <section class="related">