chef / chef/chef-web-docs

Documentation for `bash` and other similar commands

Open
#4,251 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
HTML
Stars
143
Forks
438
Avg merge
1d 10h
Merged PRs (30d)
16

Description

https://github.com/chef/chef-web-docs/blob/7ec349e7de03d5e69c71ec1c90b318425b35876c/data/infra/resources/bash.yaml#L50-L64

Its not clear how code interacts with command attributes if at all.
It appears that bash is a wrapper around script and script inherits attributes from the more generic execute resource.

  1. Is command inherited from higher scope resource? Or is it overridden to act differently by bash specifcally?
  2. if code is required, what different purpose does command serve?
  3. if this is just a wrapper around the more generic script perhaps this should be stated clearly and make references to script instead of execute resource?

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with data/infra/resources/bash.yaml at lines 50-64, then compare the documented bash, script, and execute resources. Determine how code and command relate and whether bash wraps script as described. Done means the documentation clearly answers the three questions and points to the correct related resource.

Written by the indexing model from the issue text.

Assessment

Tech stack
bash
Domain
documentation
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.