remixtures, Portuguese
@remixtures@tldr.nettime.org avatar

: "A few months ago, I wrote about why you should test docs code examples. Today, I’m going to look at how to test docs code examples.

The specifics may vary from team to team and tool to tool, but this is the broad shape of what this process looks like:

  • Write docs examples in unit test suites
  • Excerpt example code for inclusion in docs
  • Include example code in docs
  • Run docs tests in CI

In another post, I’ll dive deeper on what your docs code examples and tests should cover. For this topic, I’ll follow a code example from the unit test suite to publishing the docs."

https://dacharycarey.com/2024/01/12/how-to-test-docs-code-examples/

  • All
  • Subscribed
  • Moderated
  • Favorites
  • TechnicalWriting
  • ethstaker
  • DreamBathrooms
  • InstantRegret
  • magazineikmin
  • ngwrru68w68
  • cubers
  • thenastyranch
  • Youngstown
  • rosin
  • slotface
  • cisconetworking
  • mdbf
  • kavyap
  • Durango
  • megavids
  • khanakhh
  • GTA5RPClips
  • anitta
  • osvaldo12
  • everett
  • normalnudes
  • tester
  • tacticalgear
  • provamag3
  • modclub
  • Leos
  • JUstTest
  • lostlight
  • All magazines