migrated development documentation to markdown
This commit is contained in:
91
doc/development_documentation.md
Normal file
91
doc/development_documentation.md
Normal file
@@ -0,0 +1,91 @@
|
||||
##New build
|
||||
|
||||
Target platform is java 1.7
|
||||
##Build
|
||||
|
||||
Toecount is now part of the package which can be build with
|
||||
```
|
||||
mvn clean package
|
||||
```
|
||||
|
||||
##Test
|
||||
|
||||
`package -Dmaven.surefire.debug="-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=8000 -Xnoagent -Djava.compiler=NONE"`
|
||||
can be used as debug configuration goal in eclipse
|
||||
|
||||
|
||||
##Deployment
|
||||
A section in Maven's settings.xml is needed, in Linux (and MacOS) that's at ~/.m2/settings.xml
|
||||
|
||||
As „servers“, enter the following
|
||||
```xml
|
||||
<servers>
|
||||
<server>
|
||||
<id>github</id>
|
||||
<password>GITHUB-TOKEN</password>
|
||||
</server>
|
||||
</servers>
|
||||
```
|
||||
The whole settings.xml then looks e.g. like this
|
||||
```xml
|
||||
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
|
||||
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
|
||||
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
|
||||
https://maven.apache.org/xsd/settings-1.0.0.xsd">
|
||||
<localRepository/>
|
||||
<interactiveMode/>
|
||||
<usePluginRegistry/>
|
||||
<offline/>
|
||||
<pluginGroups/>
|
||||
<servers>
|
||||
<server>
|
||||
<id>github</id>
|
||||
<password>TOKEN</password>
|
||||
</server>
|
||||
</servers>
|
||||
<mirrors/>
|
||||
<proxies/>
|
||||
<profiles/>
|
||||
<activeProfiles/>
|
||||
</settings>
|
||||
```
|
||||
|
||||
The password is generated on github.
|
||||
See the following screenshot:
|
||||
|
||||
|
||||
Sign in in GitHub and click on the profile picture -> Settings. Now just generate a new token and set the checkboxes from the screenshot.
|
||||

|
||||
The Token-ID is the password.
|
||||
|
||||
|
||||
##Release
|
||||
|
||||
You will need a git client on the console, if that's available can e.g. be checked with "git --version" .
|
||||
Change to the root of the repo.
|
||||
|
||||
Change to the project directory and run
|
||||
* "/usr/local/Cellar/maven/3.5.2/bin/mvn clean install" . If that works you can
|
||||
* clean the release with „/usr/local/Cellar/maven/3.5.2/bin/mvn release:clean“ and prepare the release with
|
||||
* "/usr/local/Cellar/maven/3.5.2/bin/mvn release:prepare -DignoreSnapshots=true" and enter the version numbers.
|
||||
* After that is through you can create a new release via "/usr/local/Cellar/maven/3.5.2/bin/mvn release:perform -Darguments="-Dmaven.javadoc.skip=true".This will also update the maven repo.
|
||||
|
||||

|
||||
|
||||
|
||||
Afterwards you can access the release page and update the documentation, e.g. upload the jar, the jar javadoc and ZugferdDev. You can also enter a changelog and a better title.
|
||||
|
||||
|
||||
##Release process
|
||||
* Update documentation
|
||||
* write/translate announcement
|
||||
* release via/for mvn
|
||||
* Publish a github release
|
||||
* update mustangproject.org RE
|
||||
* version number and release date
|
||||
* sample file?
|
||||
* Deployment jar
|
||||
* put announcement on usegroup
|
||||
* email the mailing list
|
||||
* freshcode.club
|
||||
|
||||
Reference in New Issue
Block a user