Re: #14633 - organization of settings docs

2013-01-09 Thread Tim Graham
Thanks for the suggestion, I've added a topical index to the pull request. On Tuesday, January 8, 2013 12:49:58 PM UTC-5, ptone wrote: > > Looks good overall Tim - I do think that the primary reference should be > kept alphabetical within core - this is most useful when you have a setting > you

Re: #14633 - organization of settings docs

2013-01-08 Thread ptone
Looks good overall Tim - I do think that the primary reference should be kept alphabetical within core - this is most useful when you have a setting you need to look up. But I do think that a 'by-topic' cross reference index could also be very useful for discovering or learning about all setti

Re: #14633 - organization of settings docs

2013-01-08 Thread Tim Graham
Agreed, I'm +1 to keeping deprecated settings inline rather than moving them to their own section, but I'd defer to whoever made the original decision. On Tuesday, January 8, 2013 4:58:17 AM UTC-5, Sam Lai wrote: > > Looks good. Adds a bit more structure for browsing but doesn't > significantly

Re: #14633 - organization of settings docs

2013-01-08 Thread Sam Lai
Looks good. Adds a bit more structure for browsing but doesn't significantly change how the page is used, which is probably through CTRL-F. As mentioned by others in the issue, the distinction current and deprecated settings seems very arbitrary. I think it'll be better to sort the deprecated sett

#14633 - organization of settings docs

2013-01-07 Thread Tim Graham
I'd appreciate feedback on #14633- "Organize settings reference docs". So far I've broken out the settings for each contrib app into their own sections. The one comment on the pull request suggests further breaking up the settings listed in the "Core