Comments (5)
Also, you already cover this in a link from the page where that paragraph was found. It leads here:
http://docs.opscode.com/essentials_repository_create.html
from chef-web-docs-2016.
from chef-web-docs-2016.
Hi Jeff,
What if those two sentences were combined, like this:
"The |chef| repository is located on a workstation and should be treated like source code. The |chef| repository can be cloned directly from |github| or it can be downloaded from |github| as a |tar gz| file, and then associated with another version source control system, such as |svn|, |mercurial|, or |bazaar|."
Thoughts?
James
From: Jeff Blaine [[email protected]]
Sent: Tuesday, December 04, 2012 10:36 AM
To: opscode/chef-docs
Subject: Re: [chef-docs] Weird paragraph (#15)
—
Reply to this email directly or view it on GitHubhttps://github.com//issues/15#issuecomment-11009190.
from chef-web-docs-2016.
Hi James.
IMO, it's redundant and should really just be removed from that particular page (PR #16 above).
Somewhat separately, assuming you keep it, it is vague in that it refers to "THE chef repository can be cloned directly from..." (emphasis mine). It poses it as if there is only one canonical place to start from, but doesn't explain up front that you're talking about "the Opscode boilerplate chef repository" ... that most people clone for starters.
It's very Hosted-Chef-Customer-centric which doesn't seem right (my opinion) given that Chef is a lot more than just Hosted Chef.
Just my 2 opinionated cents!
from chef-web-docs-2016.
OK. Thanks Jeff. I will take the pull requests that you have suggested and merge them.
At some point, I intend to have Hosted-, Private-, and Open Source-specific docs so I'll save this revised paragraph stuff for the future.
James
From: Jeff Blaine [[email protected]]
Sent: Tuesday, December 04, 2012 12:00 PM
To: opscode/chef-docs
Cc: James Scott
Subject: Re: [chef-docs] Weird paragraph (#15)
Hi James.
IMO, it's redundant and should really just be removed from that particular page (PR #16#16 above).
Somewhat separately, assuming you keep it, it is vague in that it refers to "THE chef repository can be cloned directly from..." (emphasis mine). It poses it as if there is only one canonical place to start from, but doesn't explain up front that you're talking about "the Opscode boilerplate chef repository" ... that most people clone for starters.
It's very Hosted-Chef-Customer-centric which doesn't seem right (my opinion) given that Chef is a lot more than just Hosted Chef.
Just my 2 opinionated cents!
—
Reply to this email directly or view it on GitHubhttps://github.com//issues/15#issuecomment-11013082.
from chef-web-docs-2016.
Related Issues (20)
- Compliance api update HOT 3
- chef_gem examples are outdated HOT 2
- docs.chef.io missing error_messages page for external-postgresql HOT 1
- chef_gem 'compile_time' wording isn't so great HOT 2
- remove-partitions option to opscode-reporting-ctl should be documented HOT 1
- document block argument to load_current_value HOT 12
- Open source to chef server 12 link is missing from upgrade cods HOT 1
- Manually loading encrypted databags is missing from the docs
- chef generate cookbook sentence is Deep.
- Greatly expand uninstall procedure
- metadata.rb doc is wrong for 'ohai_version' HOT 1
- Docs misrepresent default behaviour of chef-client -l
- Installation of Supermarket does not seem to be documented HOT 2
- Error in : chef-web-docs-2016/includes_delivery_integration/includes_delivery_integration_ldap_attributes.rst
- General compliance.rb improvements HOT 3
- (low pri) compliance api documentation bug HOT 1
- (windows) kitchen.yml docs
- Document new Ohai ohai flags
- `chef provision` docs don't show how to include dependencies in './provision/metadata.rb'
- Chef Server /universe example return values are incorrect/misleading
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from chef-web-docs-2016.