[[TOC(heading=Procedures, sectionindex, compact, depth=3, allactive, Documentatie/Ontwikkelaar/Procedures/)]]
[[TOC(heading=Ontwikkelaar, sectionindex, compact, depth=2, allactive, Documentatie/Ontwikkelaar/)]]
[[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; als het niet in de juiste directory gedraaid wordt, klaagt het en doet het verder niks):
   {{{
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.
   - Werk `AssemblyInfo.cs` bij met het build nummer (3.YYYY.MMDD),
   - Verwijdert alle `bin/`, `obj/` en `publish/` directories in de checkout,
   - Voor elk target platform:
     - Doet een build en publish voor dat platform,
     - Zipt de resultaten.
   - Vraagt om TRAC wachtwoord en maakt een pagina aan,
   - Voor elk target platform, upload de zipfile,
   - Doet een git commit (om de aanpassing van de `AssemblyInfo.cs` op te slaan) en tagt die commit met het build nummer.
 - Vergeet niet de release-commit ook te pushen en evt. te mergen met master.