[Repoze-dev] bfg docs

2009-06-25 Thread Iain Duncan
First off, I am super impressed by the effort put into the bfg docs. The ratio of docs to code is fantastic and IMHO bodes very well for adoption. =) Second, I'm finding some small typos that could be confusing to total beginners. What's the routing for helping out here? thanks Iain

Re: [Repoze-dev] bfg docs

2009-06-25 Thread Chris McDonough
On 6/25/09 3:34 AM, Iain Duncan wrote: First off, I am super impressed by the effort put into the bfg docs. The ratio of docs to code is fantastic and IMHO bodes very well for adoption. =) Second, I'm finding some small typos that could be confusing to total beginners. What's the routing for

[Repoze-dev] bfg docs

2009-06-02 Thread Reed O'Brien
Finished a once over the API docs. Possible nit: location.html#repoze.bfg.location.locate I don't like locate as the name for the function as I expect it to find me something rather than make something location aware. I would expect it o be something like emplace, set, put or something. I

Re: [Repoze-dev] bfg docs

2009-06-02 Thread Chris McDonough
On 6/2/09 8:08 AM, Reed O'Brien wrote: Finished a once over the API docs. Possible nit: location.html#repoze.bfg.location.locate I don't like locate as the name for the function as I expect it to find me something rather than make something location aware. I would expect it o be

Re: [Repoze-dev] bfg docs

2009-06-02 Thread Chris Rossi
On Tue, Jun 2, 2009 at 9:29 AM, Chris McDonough chr...@plope.com wrote: On 6/2/09 8:08 AM, Reed O'Brien wrote: Finished a once over the API docs. Possible nit: location.html#repoze.bfg.location.locate I don't like locate as the name for the function as I expect it to find me

Re: [Repoze-dev] bfg docs

2009-06-02 Thread Chris McDonough
On 6/2/09 12:27 PM, Tres Seaver wrote: -BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Chris McDonough wrote: On 6/2/09 8:08 AM, Reed O'Brien wrote: Finished a once over the API docs. Possible nit: location.html#repoze.bfg.location.locate I don't like locate as the name for the function