tree: 6b3e149b2a0ec35d122134077ebc8e4d2c95046f [path history] [tgz]
  1. BUILD.gn
  2. OWNERS
  3. README.md
  4. dart/
  5. fuchsia.examples.docs/
  6. fuchsia.examples/
  7. go/
  8. hlcpp/
  9. llcpp/
  10. rust/
  11. test/
examples/fidl/README.md

FIDL Examples

This directory contains example code for using FIDL. fuchsia.examples contains FIDL definitions used in the various bindings-specific example directories for hlcpp, llcpp, go, and rust.

The test directory contains tests to ensure that example code is kept up to date. To run tests:

fx set core.x64 --with //examples/fidl:tests
fx test -vo //examples/fidl

All major FIDL code examples used in documentation should preferably be included from a source file somewhere in this documentation that is covered by tests. This eliminates sample code duplication and ensures that example code is kept up to date by being tested.

Although this ensures that code used in any documentation is kept up to date, it does not ensure that text referring to the code is kept in sync. When modifying code in this repo, please check that any corresponding text is kept in sync. Code can be included using a specific region:

{%includecode gerrit_repo="fuchsia/fuchsia" gerrit_path="examples/fidl/foo" region_tag="bar" %}

or using an entire file

{%includecode gerrit_repo="fuchsia/fuchsia" gerrit_path="examples/fidl/foo" %}

References can be found by grepping for these two variants in /docs.