# HG changeset patch
# User Jaroslav Tulach <jaroslav.tulach@apidesign.org>
# Date 1222100365 -7200
# Node ID 81bafaac7336a17bfaa9fd87e69352fcdbb4c5fa
# Parent  dbe3092e851dfbcf0076946f508da8dea224b52c
Explaining that the API and its impl shall be kept in one package.
Also stressing that the Convertor shall be "pre-made" in the API, no subclassing needed to create its implementation.

diff -r dbe3092e851d -r 81bafaac7336 currency/src/org/apidesign/apifest08/currency/Convertor.java
--- a/currency/src/org/apidesign/apifest08/currency/Convertor.java	Sat Sep 20 18:38:55 2008 +0200
+++ b/currency/src/org/apidesign/apifest08/currency/Convertor.java	Mon Sep 22 18:19:25 2008 +0200
@@ -1,6 +1,11 @@
 package org.apidesign.apifest08.currency;
 
-/**
+/** This is the skeleton class for your API. You need to make it public, so
+ * it is accessible to your client code (currently in Task1Test.java) file.
+ * <p>
+ * Feel free to create additional classes or rename this one, just keep all
+ * the API and its implementation in this package. Do not spread it outside
+ * to other packages.
  */
 class Convertor {
 }
diff -r dbe3092e851d -r 81bafaac7336 currency/test/org/apidesign/apifest08/test/Task1Test.java
--- a/currency/test/org/apidesign/apifest08/test/Task1Test.java	Sat Sep 20 18:38:55 2008 +0200
+++ b/currency/test/org/apidesign/apifest08/test/Task1Test.java	Mon Sep 22 18:19:25 2008 +0200
@@ -4,13 +4,12 @@
 import org.apidesign.apifest08.currency.Convertor;
 
 /** Finish the Convertor API, and then write bodies of methods inside
- * of this class to match the given tasks.
+ * of this class to match the given tasks. To fullfil your task, use the
+ * API define in the <code>org.apidesign.apifest08.currency</code> package.
+ * Do not you reflection, or other hacks as your code
+ * shall run without any runtime permissions.
  */
 public class Task1Test extends TestCase {
-    static {
-        // your code shall run without any permissions
-    }
-    
     public Task1Test(String testName) {
         super(testName);
     }
@@ -26,6 +25,9 @@
     /** Create convertor that understands two currencies, CZK and
      *  USD. Make 1 USD == 17 CZK.
      *
+     * Creation of the convertor shall not require subclassing of any class
+     * or interface on the client side.
+     *
      * @return prepared convertor ready for converting USD to CZK and CZK to USD
      */
     public static Convertor createCZKtoUSD() {
@@ -35,6 +37,9 @@
     /** Create convertor that understands two currencies, CZK and
      *  SKK. Make 100 SKK == 80 CZK.
      *
+     * Creation of the convertor shall not require subclassing of any class
+     * or interface on the client side.
+     * 
      * @return prepared convertor ready for converting SKK to CZK and CZK to SKK
      */
     public static Convertor createSKKtoCZK() {