Sha256: 8f55b57bf24de1bce7993b7cf0151944a82264f3f5ba6098dc6909dc8483716e

Contents?: true

Size: 715 Bytes

Versions: 1

Compression:

Stored size: 715 Bytes

Contents

### Evergreen Examples

Example code and output that's embedded in a markdown file is dead text that may no longer be correct.

Use the markdown helper to include example code and output -- but only after the project "build" has re-run the code and refreahed the output!

Here's how:

1.  Maintain each code example in a separate executable file.
1.  Maintain markdown files that have include desctiptions, rather than embedded code and output.
1.  At project "build time" (controlled by a suitable build tool):
    1.  Execute each code example, capturing its output to one or more files.
    1.  Check output for errors and validity.
    1.  Run the markdown helper to re-assemble the markdown files.

Version data entries

1 entries across 1 versions & 1 rubygems

Version Path
markdown_helper-1.5.0 readme_files/use_cases/evergreen_examples.md