DownloadYou can first select a configuration map version and then download it by clicking on the download link. Perhaps a more convenient way is using the VAStGoodies.com Tools. Possible required maps will not be included in the download.
UploadYou can submit open source code contributions by uploading a configuration map using the VAStGoodies.com Tools.
Do not upload versions that were shipped in Instantiations (or IBM) official releases (including alpha versions, beta versions, etc.). If you need a shipped version of a VAStGoodies.com map (e.g. to compare changes between the shipped version and the VAStGoodies.com version based on it) and you do not already have it (e.g. because you are using a newer VASmalltalk release and the VAStGoodies.com version is based on a version shipped in an older release), you can obtain the old shipped version from the manager.dat in the appropriate va..._mw.zip download available at http://www.instantiations.com/products/vasmalltalk/download-prior.html.
Do not upload software without assigning a licence. The MIT licence (http://www.opensource.org/licenses/mit-license.php), also sometimes called the X11 licence, is often used for software on this site. Various other licences (modified MIT, BSD, LGPL, etc.) are also used for open-source software, or a project can provide its own.
Uploaded configuration maps are immediately visible. Associated developer and project annotations will be updated with every upload.
AnnotationsYou can add various annotations to provide information about you and your project using VAStGoodies Tools. After you have loaded the tools, open the Configuration Map Browser, right-click on the Editions and Versions pane, and choose Edit Projects Annotations from the context menu. The "project" annotation is used to group configuration maps together. The most recent version of each configuration map that is part of a project is used. If several configuration maps in a project provide different values for the same annotation, multiple values will be displayed for the project. In the "description" field of the Developer and Project tabs, you can use a wiki syntax, which will be processed when rendering the pages on VAStGoodies.
Wiki syntaxThe syntax of the wiki like annotations is similar to Pier. Escaping doesn't work though.
|*label>account@domain*||Labeled email link|
Best practicesSome recommendations that will help you using the potential VAStGoodies.com is offering.
- Make yourself manager of the configuration maps that you upload. This information is used to populate various pages on this site, including the statistics page.
- Fill in the notes and/or comments from the maps you provide.
- Name an open source licence in the annotations of your project.
- Provide additional information about your project in the annotations and/or include links to it from there.
- Group multiple configuration maps in to one project, if appropiate, using the project annotation as described above.
- Divide deployable code and development code (including tests) in separate configuration maps.
Informative readsYou can find more useful, if not essential, information at the following links.
- James Robertson's blog and screencast about VAStGoodies.
- James Robertson's blog and screencast about publishing to VAStGoodies.com.
- Ernest Micklei on the VAStGoodies.com Tools.
- Adriaan van Os on porting from Pharo/Squeak.
- Adriaan van Os' VA Smalltalk Summit 2009 presentation about VAStGoodies.com, OSS and porting. (recording | pdf).
- Smalltalk Inspect podcast on VAStGoodies and more with Adriaan van Os, Marten Feldtmann, Joachim Tuchel and Sebastian Heidbrink.
- The official VAStGoodies.com discussion thread at the Google VA Smalltalk group.
- The old VAStGoodies.com discussion thread.