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/logpmf/README.md

@@ -157,6 +157,112 @@ 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/logpmf.h"
+```
+
+#### stdlib_base_dists_hypergeometric_logpmf( x, N, K, n )
+
+Evaluates the natural logarithm of the probability mass function (PMF) for a hypergeometric distribution.
+
+```c
+double out = stdlib_base_dists_hypergeometric_logpmf( 1.0, 8, 4, 2 );
+// returns ~-0.56
+```
+
+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_logpmf ( 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/logpmf.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 log_pmf;
+    int i;
+
+    for ( i = 0; i < 10; i++ ) {
+        N = stdlib_base_round(random_uniform(5.0, 20.0));
+        K = stdlib_base_round(random_uniform(0.0, N));
+        n = stdlib_base_round(random_uniform(0.0, K));
+        x = stdlib_base_round(random_uniform(0.0, n));
+
+        log_pmf = stdlib_base_dists_hypergeometric_logpmf( x, N, K, n );
+
+        printf( "N: %lf, K: %lf, n: %lf, x: %lf, Log PMF: %lf\n", N, K, n, x, log_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">