chef

https://github.com/opscode/chef

Ruby

A systems integration framework, built to bring the benefits of configuration management to your entire infrastructure.

Chef::ChefFS::FileSystem::BaseFSObject#child

Get a child of this entry with the given name.  This MUST always
return a child, even if it is NonexistentFSObject.  Overriders should
take caution not to do expensive network requests to get the list of
children to fulfill this request, unless absolutely necessary here; it
is intended as a quick way to traverse a hierarchy.

For example, knife show /data_bags/x/y.json will call
root.child('data_bags').child('x').child('y.json'), which can then
directly perform a network request to retrieve the y.json data bag.  No
network request was necessary to retrieve

Source | Google | Stack overflow

Edit

git clone [email protected]:opscode/chef.git

cd chef

open lib/chef/chef_fs/file_system/base_fs_object.rb

Contribute

# Make a new branch

git checkout -b -your-name--update-docs-Chef--ChefFS--FileSystem--BaseFSObject-child-for-pr

# Commit to git

git add lib/chef/chef_fs/file_system/base_fs_object.rbgit commit -m "better docs for Chef::ChefFS::FileSystem::BaseFSObject#child"

# Open pull request

gem install hub # on a mac you can `brew install hub`

hub fork

git push <your name> -your-name--update-docs-Chef--ChefFS--FileSystem--BaseFSObject-child-for-pr

hub pull-request

# Celebrate!