[[TOC(heading=Omgeving, sectionindex, compact, depth=3, allactive, Documentatie/Ontwikkelaar/Omgeving/)]]
[[TOC(heading=Procedures, sectionindex, compact, depth=3, allactive, Documentatie/Ontwikkelaar/Procedures/)]]
[[TOC(heading=Documentatie, sectionindex, compact, depth=1, allactive, Documentatie/)]]

= OpenAC 3 Server Releases =

OpenAC 3 Server wordt in een git repository ontwikkeld, binnen de Visual Studio omgevind van de FENAC.

Er is geen beleid over wanneer er een nieuwe OpenAC 3 Server build wordt vrijgegeven. Op dit moment -- maart 2017 -- is de stelregel om de paar dagen, als er weer een nieuw feature is toegevoegd of als er een bug is opgelost. 

Om de snelle releases te ondersteunen is er een release-script, die de release bouwt, release pagina's aanmaakt in de wiki (onder [ServerReleases]), de zipfiles aan de wiki hangt, en een git tag maakt om vast te leggen waar de build vandaan komt.

== Nieuwe Release ==

Om een release te maken:

 - Checkout de commit die je wilt gebruiken om een nieuwe release te maken. Meestal is dat ''master'', maar je kunt natuurlijk ook een andere commit gebruiken. Ga '''niet''' aan `AssemblyInfo.cs` sleutelen, want dat wordt gegenereerd als onderdeel van de build.
 - Controleer eerst of de build wel goed gaat.
 - Draai vervolgens het release script (in de top-level `OpenACWebCore/` directory):
   {{{
python packaging/release.py
}}}
 - Het script is vrij uitvoerig gedocumenteerd; het maakt wat dingen schoon, werkt `AssemblyInfo.cs` bij, draait `dotnet restore` en `dotnet publish` voor de target platforms (win7 en win81), en zipt het bij elkaar.
 - Als de build lukt, vraagt het script om TRAC credentials: username en password.
 - Daarna maakt het script een release-pagina aan en worden de zipfiles geupload.
 - Tot slot gebruikt het release script `git commit` en `git tag` om de bijgewerkte `AssemblyInfo.cs` (met het build-nummer van vandaag) te committen en te taggen zodat de release builds teruggevonden kunnen worden.
 - Vergeet niet de release-commit ook te pushen en evt. te mergen met master.