comments on the API

Previous Topic Next Topic
 
classic Classic list List threaded Threaded
7 messages Options
Reply | Threaded
Open this post in threaded view
|

comments on the API

abergel
Hi Dale,

It was good to see you at stic. I just added a few comments on:

https://github.com/dalehenrich/MetacelloScriptingApiSpec/wiki

I commented on the introduction, load and commit commands. I did not do my pass on the whole document because I have some essential questions. My comments/questions are indicated with a @@.

Let me know when do you want me to look at it again.

this is all good stuff! Very promising!

Cheers,
Alexandre
--
_,.;:~^~:;._,.;:~^~:;._,.;:~^~:;._,.;:~^~:;._,.;:
Alexandre Bergel  http://www.bergel.eu
^~:;._,.;:~^~:;._,.;:~^~:;._,.;:~^~:;._,.;:~^~:;.





Reply | Threaded
Open this post in threaded view
|

Re: comments on the API

Dale Henrichs
Excellent!

I will have a chance to go through your comments this afternoon...

Dale

----- Original Message -----
| From: "Alexandre Bergel" <[hidden email]>
| To: [hidden email]
| Sent: Thursday, March 29, 2012 6:24:41 AM
| Subject: [Metacello] comments on the API
|
| Hi Dale,
|
| It was good to see you at stic. I just added a few comments on:
|
| https://github.com/dalehenrich/MetacelloScriptingApiSpec/wiki
|
| I commented on the introduction, load and commit commands. I did not
| do my pass on the whole document because I have some essential
| questions. My comments/questions are indicated with a @@.
|
| Let me know when do you want me to look at it again.
|
| this is all good stuff! Very promising!
|
| Cheers,
| Alexandre
| --
| _,.;:~^~:;._,.;:~^~:;._,.;:~^~:;._,.;:~^~:;._,.;:
| Alexandre Bergel  http://www.bergel.eu
| ^~:;._,.;:~^~:;._,.;:~^~:;._,.;:~^~:;._,.;:~^~:;.
|
|
|
|
|
|
Reply | Threaded
Open this post in threaded view
|

Re: comments on the API

Dale Henrichs
In reply to this post by abergel
Alex,

I agree with your comments on the Home page for the wiki:

  "Why do we talk here about the configuration?"

I agree that the configuration shouldn't be discussed this early in the introduction page ... I expect that the intro will be rewritten at some point...

I am looking for feedback on the Glossary page[1] right now. The scripting API is intended to be used by folks who are using configurations today so part of the message will be how to transition from using:

  Gofer new
    squeaksource: 'MetacelloRepository';
    package: 'ConfigurationOfMoose';
    load.
  ((Smalltalk at: #ConfigurationOfMoose) project version: '1.0') load.

to:

  Metacello new
    project: 'Moose';
    version '1.0';
    load

as well as describing the new behavior (github repositories, no automatic upgrades, VersionOf and project registration).

The Glossary isn't the whole package, but it is a starting point.

Dale

[1] https://github.com/dalehenrich/MetacelloScriptingApiSpec/wiki/Glossaryofterms


----- Original Message -----
| From: "Alexandre Bergel" <[hidden email]>
| To: [hidden email]
| Sent: Thursday, March 29, 2012 6:24:41 AM
| Subject: [Metacello] comments on the API
|
| Hi Dale,
|
| It was good to see you at stic. I just added a few comments on:
|
| https://github.com/dalehenrich/MetacelloScriptingApiSpec/wiki
|
| I commented on the introduction, load and commit commands. I did not
| do my pass on the whole document because I have some essential
| questions. My comments/questions are indicated with a @@.
|
| Let me know when do you want me to look at it again.
|
| this is all good stuff! Very promising!
|
| Cheers,
| Alexandre
| --
| _,.;:~^~:;._,.;:~^~:;._,.;:~^~:;._,.;:~^~:;._,.;:
| Alexandre Bergel  http://www.bergel.eu
| ^~:;._,.;:~^~:;._,.;:~^~:;._,.;:~^~:;._,.;:~^~:;.
|
|
|
|
|
|
Reply | Threaded
Open this post in threaded view
|

Re: comments on the API

abergel
Cool!
Let me know when I can do another pass on https://github.com/dalehenrich/MetacelloScriptingApiSpec/wiki

In the meantime, I have added some comments on https://github.com/dalehenrich/MetacelloScriptingApiSpec/wiki/Glossaryofterms

I used **@@ ... * in my annotation. If you prefer that I highlight my comments/questions in a different way, let me know.

Cheers,
Alexandre



On 29 Mar 2012, at 17:58, Dale Henrichs wrote:

> Alex,
>
> I agree with your comments on the Home page for the wiki:
>
>  "Why do we talk here about the configuration?"
>
> I agree that the configuration shouldn't be discussed this early in the introduction page ... I expect that the intro will be rewritten at some point...
>
> I am looking for feedback on the Glossary page[1] right now. The scripting API is intended to be used by folks who are using configurations today so part of the message will be how to transition from using:
>
>  Gofer new
>    squeaksource: 'MetacelloRepository';
>    package: 'ConfigurationOfMoose';
>    load.
>  ((Smalltalk at: #ConfigurationOfMoose) project version: '1.0') load.
>
> to:
>
>  Metacello new
>    project: 'Moose';
>    version '1.0';
>    load
>
> as well as describing the new behavior (github repositories, no automatic upgrades, VersionOf and project registration).
>
> The Glossary isn't the whole package, but it is a starting point.
>
> Dale
>
> [1] https://github.com/dalehenrich/MetacelloScriptingApiSpec/wiki/Glossaryofterms
>
>
> ----- Original Message -----
> | From: "Alexandre Bergel" <[hidden email]>
> | To: [hidden email]
> | Sent: Thursday, March 29, 2012 6:24:41 AM
> | Subject: [Metacello] comments on the API
> |
> | Hi Dale,
> |
> | It was good to see you at stic. I just added a few comments on:
> |
> | https://github.com/dalehenrich/MetacelloScriptingApiSpec/wiki
> |
> | I commented on the introduction, load and commit commands. I did not
> | do my pass on the whole document because I have some essential
> | questions. My comments/questions are indicated with a @@.
> |
> | Let me know when do you want me to look at it again.
> |
> | this is all good stuff! Very promising!
> |
> | Cheers,
> | Alexandre
> | --
> | _,.;:~^~:;._,.;:~^~:;._,.;:~^~:;._,.;:~^~:;._,.;:
> | Alexandre Bergel  http://www.bergel.eu
> | ^~:;._,.;:~^~:;._,.;:~^~:;._,.;:~^~:;._,.;:~^~:;.
> |
> |
> |
> |
> |
> |

--
_,.;:~^~:;._,.;:~^~:;._,.;:~^~:;._,.;:~^~:;._,.;:
Alexandre Bergel  http://www.bergel.eu
^~:;._,.;:~^~:;._,.;:~^~:;._,.;:~^~:;._,.;:~^~:;.





Reply | Threaded
Open this post in threaded view
|

Re: comments on the API

Dale Henrichs
Excellent! I welcome feedback i nthe form that's convenient for you:)

I'll take a look this afternoon, thanks.

Dale

----- Original Message -----
| From: "Alexandre Bergel" <[hidden email]>
| To: [hidden email]
| Sent: Friday, March 30, 2012 7:23:02 AM
| Subject: Re: [Metacello] comments on the API
|
| Cool!
| Let me know when I can do another pass on
| https://github.com/dalehenrich/MetacelloScriptingApiSpec/wiki
|
| In the meantime, I have added some comments on
| https://github.com/dalehenrich/MetacelloScriptingApiSpec/wiki/Glossaryofterms
|
| I used **@@ ... * in my annotation. If you prefer that I highlight my
| comments/questions in a different way, let me know.
|
| Cheers,
| Alexandre
|
|
|
| On 29 Mar 2012, at 17:58, Dale Henrichs wrote:
|
| > Alex,
| >
| > I agree with your comments on the Home page for the wiki:
| >
| >  "Why do we talk here about the configuration?"
| >
| > I agree that the configuration shouldn't be discussed this early in
| > the introduction page ... I expect that the intro will be
| > rewritten at some point...
| >
| > I am looking for feedback on the Glossary page[1] right now. The
| > scripting API is intended to be used by folks who are using
| > configurations today so part of the message will be how to
| > transition from using:
| >
| >  Gofer new
| >    squeaksource: 'MetacelloRepository';
| >    package: 'ConfigurationOfMoose';
| >    load.
| >  ((Smalltalk at: #ConfigurationOfMoose) project version: '1.0')
| >  load.
| >
| > to:
| >
| >  Metacello new
| >    project: 'Moose';
| >    version '1.0';
| >    load
| >
| > as well as describing the new behavior (github repositories, no
| > automatic upgrades, VersionOf and project registration).
| >
| > The Glossary isn't the whole package, but it is a starting point.
| >
| > Dale
| >
| > [1]
| > https://github.com/dalehenrich/MetacelloScriptingApiSpec/wiki/Glossaryofterms
| >
| >
| > ----- Original Message -----
| > | From: "Alexandre Bergel" <[hidden email]>
| > | To: [hidden email]
| > | Sent: Thursday, March 29, 2012 6:24:41 AM
| > | Subject: [Metacello] comments on the API
| > |
| > | Hi Dale,
| > |
| > | It was good to see you at stic. I just added a few comments on:
| > |
| > | https://github.com/dalehenrich/MetacelloScriptingApiSpec/wiki
| > |
| > | I commented on the introduction, load and commit commands. I did
| > | not
| > | do my pass on the whole document because I have some essential
| > | questions. My comments/questions are indicated with a @@.
| > |
| > | Let me know when do you want me to look at it again.
| > |
| > | this is all good stuff! Very promising!
| > |
| > | Cheers,
| > | Alexandre
| > | --
| > | _,.;:~^~:;._,.;:~^~:;._,.;:~^~:;._,.;:~^~:;._,.;:
| > | Alexandre Bergel  http://www.bergel.eu
| > | ^~:;._,.;:~^~:;._,.;:~^~:;._,.;:~^~:;._,.;:~^~:;.
| > |
| > |
| > |
| > |
| > |
| > |
|
| --
| _,.;:~^~:;._,.;:~^~:;._,.;:~^~:;._,.;:~^~:;._,.;:
| Alexandre Bergel  http://www.bergel.eu
| ^~:;._,.;:~^~:;._,.;:~^~:;._,.;:~^~:;._,.;:~^~:;.
|
|
|
|
|
|
Reply | Threaded
Open this post in threaded view
|

Re: comments on the API

Dale Henrichs
In reply to this post by abergel
Alex,

I transferred your comments to MetacelloScriptingApiSpec issues[1], so that we can discuss the issues/resolutions. I think I've addressed most of the issues you raised.

If you want to open an issue that'd be great but if it easier for you to comment using @@ then continue to do so...

Thanks,

Dale

[1] https://github.com/dalehenrich/MetacelloScriptingApiSpec/issues

----- Original Message -----
| From: "Alexandre Bergel" <[hidden email]>
| To: [hidden email]
| Sent: Friday, March 30, 2012 7:23:02 AM
| Subject: Re: [Metacello] comments on the API
|
| Cool!
| Let me know when I can do another pass on
| https://github.com/dalehenrich/MetacelloScriptingApiSpec/wiki
|
| In the meantime, I have added some comments on
| https://github.com/dalehenrich/MetacelloScriptingApiSpec/wiki/Glossaryofterms
|
| I used **@@ ... * in my annotation. If you prefer that I highlight my
| comments/questions in a different way, let me know.
|
| Cheers,
| Alexandre
|
|
|
| On 29 Mar 2012, at 17:58, Dale Henrichs wrote:
|
| > Alex,
| >
| > I agree with your comments on the Home page for the wiki:
| >
| >  "Why do we talk here about the configuration?"
| >
| > I agree that the configuration shouldn't be discussed this early in
| > the introduction page ... I expect that the intro will be
| > rewritten at some point...
| >
| > I am looking for feedback on the Glossary page[1] right now. The
| > scripting API is intended to be used by folks who are using
| > configurations today so part of the message will be how to
| > transition from using:
| >
| >  Gofer new
| >    squeaksource: 'MetacelloRepository';
| >    package: 'ConfigurationOfMoose';
| >    load.
| >  ((Smalltalk at: #ConfigurationOfMoose) project version: '1.0')
| >  load.
| >
| > to:
| >
| >  Metacello new
| >    project: 'Moose';
| >    version '1.0';
| >    load
| >
| > as well as describing the new behavior (github repositories, no
| > automatic upgrades, VersionOf and project registration).
| >
| > The Glossary isn't the whole package, but it is a starting point.
| >
| > Dale
| >
| > [1]
| > https://github.com/dalehenrich/MetacelloScriptingApiSpec/wiki/Glossaryofterms
| >
| >
| > ----- Original Message -----
| > | From: "Alexandre Bergel" <[hidden email]>
| > | To: [hidden email]
| > | Sent: Thursday, March 29, 2012 6:24:41 AM
| > | Subject: [Metacello] comments on the API
| > |
| > | Hi Dale,
| > |
| > | It was good to see you at stic. I just added a few comments on:
| > |
| > | https://github.com/dalehenrich/MetacelloScriptingApiSpec/wiki
| > |
| > | I commented on the introduction, load and commit commands. I did
| > | not
| > | do my pass on the whole document because I have some essential
| > | questions. My comments/questions are indicated with a @@.
| > |
| > | Let me know when do you want me to look at it again.
| > |
| > | this is all good stuff! Very promising!
| > |
| > | Cheers,
| > | Alexandre
| > | --
| > | _,.;:~^~:;._,.;:~^~:;._,.;:~^~:;._,.;:~^~:;._,.;:
| > | Alexandre Bergel  http://www.bergel.eu
| > | ^~:;._,.;:~^~:;._,.;:~^~:;._,.;:~^~:;._,.;:~^~:;.
| > |
| > |
| > |
| > |
| > |
| > |
|
| --
| _,.;:~^~:;._,.;:~^~:;._,.;:~^~:;._,.;:~^~:;._,.;:
| Alexandre Bergel  http://www.bergel.eu
| ^~:;._,.;:~^~:;._,.;:~^~:;._,.;:~^~:;._,.;:~^~:;.
|
|
|
|
|
|
Reply | Threaded
Open this post in threaded view
|

Re: comments on the API

abergel
I worked a bit on the issues.
How is the command page going?
https://github.com/dalehenrich/MetacelloScriptingApiSpec/wiki/Commands

Ping us when you want feedback.

Cheers,
Alexandre


On 30 Mar 2012, at 16:55, Dale Henrichs wrote:

> Alex,
>
> I transferred your comments to MetacelloScriptingApiSpec issues[1], so that we can discuss the issues/resolutions. I think I've addressed most of the issues you raised.
>
> If you want to open an issue that'd be great but if it easier for you to comment using @@ then continue to do so...
>
> Thanks,
>
> Dale
>
> [1] https://github.com/dalehenrich/MetacelloScriptingApiSpec/issues
>
> ----- Original Message -----
> | From: "Alexandre Bergel" <[hidden email]>
> | To: [hidden email]
> | Sent: Friday, March 30, 2012 7:23:02 AM
> | Subject: Re: [Metacello] comments on the API
> |
> | Cool!
> | Let me know when I can do another pass on
> | https://github.com/dalehenrich/MetacelloScriptingApiSpec/wiki
> |
> | In the meantime, I have added some comments on
> | https://github.com/dalehenrich/MetacelloScriptingApiSpec/wiki/Glossaryofterms
> |
> | I used **@@ ... * in my annotation. If you prefer that I highlight my
> | comments/questions in a different way, let me know.
> |
> | Cheers,
> | Alexandre
> |
> |
> |
> | On 29 Mar 2012, at 17:58, Dale Henrichs wrote:
> |
> | > Alex,
> | >
> | > I agree with your comments on the Home page for the wiki:
> | >
> | >  "Why do we talk here about the configuration?"
> | >
> | > I agree that the configuration shouldn't be discussed this early in
> | > the introduction page ... I expect that the intro will be
> | > rewritten at some point...
> | >
> | > I am looking for feedback on the Glossary page[1] right now. The
> | > scripting API is intended to be used by folks who are using
> | > configurations today so part of the message will be how to
> | > transition from using:
> | >
> | >  Gofer new
> | >    squeaksource: 'MetacelloRepository';
> | >    package: 'ConfigurationOfMoose';
> | >    load.
> | >  ((Smalltalk at: #ConfigurationOfMoose) project version: '1.0')
> | >  load.
> | >
> | > to:
> | >
> | >  Metacello new
> | >    project: 'Moose';
> | >    version '1.0';
> | >    load
> | >
> | > as well as describing the new behavior (github repositories, no
> | > automatic upgrades, VersionOf and project registration).
> | >
> | > The Glossary isn't the whole package, but it is a starting point.
> | >
> | > Dale
> | >
> | > [1]
> | > https://github.com/dalehenrich/MetacelloScriptingApiSpec/wiki/Glossaryofterms
> | >
> | >
> | > ----- Original Message -----
> | > | From: "Alexandre Bergel" <[hidden email]>
> | > | To: [hidden email]
> | > | Sent: Thursday, March 29, 2012 6:24:41 AM
> | > | Subject: [Metacello] comments on the API
> | > |
> | > | Hi Dale,
> | > |
> | > | It was good to see you at stic. I just added a few comments on:
> | > |
> | > | https://github.com/dalehenrich/MetacelloScriptingApiSpec/wiki
> | > |
> | > | I commented on the introduction, load and commit commands. I did
> | > | not
> | > | do my pass on the whole document because I have some essential
> | > | questions. My comments/questions are indicated with a @@.
> | > |
> | > | Let me know when do you want me to look at it again.
> | > |
> | > | this is all good stuff! Very promising!
> | > |
> | > | Cheers,
> | > | Alexandre
> | > | --
> | > | _,.;:~^~:;._,.;:~^~:;._,.;:~^~:;._,.;:~^~:;._,.;:
> | > | Alexandre Bergel  http://www.bergel.eu
> | > | ^~:;._,.;:~^~:;._,.;:~^~:;._,.;:~^~:;._,.;:~^~:;.
> | > |
> | > |
> | > |
> | > |
> | > |
> | > |
> |
> | --
> | _,.;:~^~:;._,.;:~^~:;._,.;:~^~:;._,.;:~^~:;._,.;:
> | Alexandre Bergel  http://www.bergel.eu
> | ^~:;._,.;:~^~:;._,.;:~^~:;._,.;:~^~:;._,.;:~^~:;.
> |
> |
> |
> |
> |
> |

--
_,.;:~^~:;._,.;:~^~:;._,.;:~^~:;._,.;:~^~:;._,.;:
Alexandre Bergel  http://www.bergel.eu
^~:;._,.;:~^~:;._,.;:~^~:;._,.;:~^~:;._,.;:~^~:;.