[chef] Re: Re: Re: RE: Revamped Docs Site


Chronological Thread 
  • From: Christopher Webber < >
  • To:
  • Subject: [chef] Re: Re: Re: RE: Revamped Docs Site
  • Date: Fri, 25 Sep 2015 12:46:16 -0700

So we are still working out the kinks, but… you can at least go look at this for specific versions of chef…

https://docs.chef.io/release/server_12-1/ctl_chef_server.html#org-user-remove < 12.1 (I will note that that anchor doesn’t work, because that command isn’t there)

I know it isn’t super clear when it was added, but at least you can choose the version of the docs that make sense for what you are running.


Thanks for the feedback!

— cwebber


On Sep 25, 2015, at 12:37 PM, Stephen Rosen < " class=""> > wrote:

First of all, I like the redesign a lot.
The new navbar on the left seems particularly nice.

However, this is an opportunity to voice a gripe I've had for a long time about the docs, and which I think is both fixable in the short term and much more important than a mobile-friendly redesign.
Can we please, please, pretty please, get version numbers noted on pages?
This is especially important for `knife` docs.
It's frustrating to look at a page on the doc site and say "Hmm. Was this page updated after Chef 12 was released?"

I'm not insisting that every version of every command be documented on the site -- although, frankly, I think that is a highly automatable process -- but just that when I look at the info for `chef-server-ctl org-user-remove` ( https://docs.chef.io/ctl_chef_server.html#org-user-remove ) I can know which version of Chef that documentation refers to.
I pick that example because the `knife edit` command given there is, to the best of my knowledge, wrong for Chef 12.
If I can't have the right command for the current version, at least tell me that the doc dates from an earlier version of Chef.

All that said, I stand by my initial statement that the redesign is good and gives me the warm fuzzies.
Thanks very much,
-Stephen

We appreciate the effort!

On Fri, Sep 25, 2015 at 6:23 AM, Alex Neihaus < " target="_blank" class=""> > wrote:
Hi. This is a very nice update and much appreciated.

I’m a newbie – and I find it frustrating for doc on the relevant chef.io page to refer to GitHub which refers back to chef.io. I also wish all options were document, with relevant examples on a page somehere and not just in the help text of the command itself. IMO, the complete product doc should be on your site. Knife ec2 (which I am currently learning) is one such example.

Alex

From: Christopher Webber [mailto: " target="_blank" class=""> ]
Sent: Friday, September 25, 2015 07:21
To: " target="_blank" class="">
Subject: [chef] Revamped Docs Site

Hey All,

For those of you that haven’t been to https://docs.chef.io since about 21:00 UTC yesterday (2015-09-24), we have launch a major redesign of the Docs site. The content hasn’t changed significantly but, along with a fresh new design, it is now browsable on mobile and tablet. Hopefully y’all feel like it is as much of an upgrade as we do. Please let me know if you hit any issue. Additionally you can provide feedback by going to https://docs.chef.io/feedback.html.

Thanks!

— cwebber





Archive powered by MHonArc 2.6.16.

§