| | 58 | |
| | 59 | |
| | 60 | |
| | 61 | === /apps === |
| | 62 | Apps are applications designed to be used by an end-user. For example: /apps/xgap. |
| | 63 | |
| | 64 | Each app is structured as follows: |
| | 65 | * root package org.molgenis.<appname> contains specific sources and resourses |
| | 66 | * <appname>.properties file has settings for this app [move to build.xml?] |
| | 67 | * <appname>.testng.xml files lists all tests for this app (see hudson) |
| | 68 | * <appname>_ui.xml lists the user interface design for this app |
| | 69 | |
| | 70 | Developers of apps have complete freedom to do what they want within their app as other apps will ignore any code in these folders. |
| | 71 | |
| | 72 | === /modules === |
| | 73 | Modules are bundles of code that are shared between two or more apps. For example: /modules/auth. |
| | 74 | |
| | 75 | Each module is structured as follows: |
| | 76 | * root package org.molgenis.<modulename> contains specific sources and resourses |
| | 77 | * <modulename>.properties file has settings to setup a test molgenis for this module only (see hudson) |
| | 78 | * <modulemame>.testng.xml files lists all tests for this module (see hudson) |
| | 79 | * <modulename>_ui.xml lists a user interface design for this module; apps may choose to [ref] import this ui design into their application. |
| | 80 | |
| | 81 | Developers of modules are required to: |
| | 82 | * ensure stability of the modules by providing sufficient tests and stable programming interfaces. |
| | 83 | * mark yet unstable modules with a suffix as '-dev'. For example /modules/matrix-dev. |
| | 84 | * when changing an existing module copy it into a -dev version and develop on that until the code is stable before promoting it to stable |
| | 85 | * monitor the tests of all dependent apps on hudson and fix or undo any problems they you may have caused. |
| | 86 | |
| | 87 | === /generated (svn:ignore) === |
| | 88 | This folder contains all program resources autogenerated by the build script. |
| | 89 | Typically, there are: |
| | 90 | * /java -- generated java |
| | 91 | * /python -- generated python |
| | 92 | * /cpp -- generated c++ code |
| | 93 | |
| | 94 | NB: this folder is never committed to SVN (svn:ignore). |
| | 95 | === /WebContent === |
| | 96 | All resources for the web, such as images, css and javascript, can be stored in /WebContent. |
| | 97 | Each app or module will create subfolders. For example: |
| | 98 | |
| | 99 | * /res -- contains resource files that are created by hand |
| | 100 | * /css -- contains css files |
| | 101 | * /xgap -- contains xgap specific css files |
| | 102 | * /img -- contains images |
| | 103 | * /xgap -- contains xgap specific css files |
| | 104 | * /scritps -- contains scripts. |
| | 105 | * /xgap -- contains xgap specific css files |
| | 106 | * /generated-res -- contains generator produced resource files (svn:ignore). |
| | 107 | |
| | 108 | === /dist (svn:ignore) === |
| | 109 | |
| | 110 | This folder contains all resources produced by the build script. |
| | 111 | This includes: |
| | 112 | |
| | 113 | * /dist/classes -- all compiled class files and copy of *.property and *.ftl files |
| | 114 | * /dist/test-output -- result of the tests |
| | 115 | * /dist/javadoc -- generated javadoc for your app |
| | 116 | * /dist/<name>.war -- generated war for deployment on tomcat and mysql |
| | 117 | * /dist/<name>.jar -- generated jar for standalone running of the app |
| | 118 | |
| 95 | | === /apps === |
| 96 | | Apps are applications designed to be used by an end-user. For example: /apps/xgap. |
| 97 | | |
| 98 | | Each app is structured as follows: |
| 99 | | * root package org.molgenis.<appname> contains specific sources and resourses |
| 100 | | * <appname>.properties file has settings for this app [move to build.xml?] |
| 101 | | * <appname>.testng.xml files lists all tests for this app (see hudson) |
| 102 | | * <appname>_ui.xml lists the user interface design for this app |
| 103 | | |
| 104 | | Developers of apps have complete freedom to do what they want within their app as other apps will ignore any code in these folders. |
| 105 | | |
| 106 | | === /modules === |
| 107 | | Modules are bundles of code that are shared between two or more apps. For example: /modules/auth. |
| 108 | | |
| 109 | | Each module is structured as follows: |
| 110 | | * root package org.molgenis.<modulename> contains specific sources and resourses |
| 111 | | * <modulename>.properties file has settings to setup a test molgenis for this module only (see hudson) |
| 112 | | * <modulemame>.testng.xml files lists all tests for this module (see hudson) |
| 113 | | * <modulename>_ui.xml lists a user interface design for this module; apps may choose to [ref] import this ui design into their application. |
| 114 | | |
| 115 | | Developers of modules are required to: |
| 116 | | * ensure stability of the modules by providing sufficient tests and stable programming interfaces. |
| 117 | | * mark yet unstable modules with a suffix as '-dev'. For example /modules/matrix-dev. |
| 118 | | * when changing an existing module copy it into a -dev version and develop on that until the code is stable before promoting it to stable |
| 119 | | * monitor the tests of all dependent apps on hudson and fix or undo any problems they you may have caused. |
| 120 | | |
| 121 | | === /generated (svn:ignore) === |
| 122 | | This folder contains all program resources autogenerated by the build script. |
| 123 | | Typically, there are: |
| 124 | | * /java -- generated java |
| 125 | | * /python -- generated python |
| 126 | | * /cpp -- generated c++ code |
| 127 | | |
| 128 | | NB: this folder is never committed to SVN (svn:ignore). |
| 129 | | |
| 130 | | |
| 131 | | === /WebContent === |
| 132 | | All resources for the web, such as images, css and javascript, can be stored in /WebContent. |
| 133 | | Each app or module will create subfolders. For example: |
| 134 | | |
| 135 | | * /res -- contains resource files that are created by hand |
| 136 | | * /css -- contains css files |
| 137 | | * /xgap -- contains xgap specific css files |
| 138 | | * /img -- contains images |
| 139 | | * /xgap -- contains xgap specific css files |
| 140 | | * /scritps -- contains scripts. |
| 141 | | * /xgap -- contains xgap specific css files |
| 142 | | * /generated-res -- contains generator produced resource files (svn:ignore). |
| 143 | | |
| 144 | | === /dist (svn:ignore) === |
| 145 | | |
| 146 | | |