Gedocumenteerde helpfunctie

[ranthonissen]

Overgenomen van Het Vlaams Hobbybrouwers Forum

Hoe zou je het graag zien?
Zie thread van op het forum hieronder

Wat ook mooi en handig zou zijn is een goed gedocumenteerde helpfunctie.

Dat is waar het bij vele pakketten aan ontbreekt of waar bij het onvolledig is (de handleiding van brouwhulp is absoluut onvolledig), als gevorderde rot in het brouwen kan je bepaalde kronkels van een brouwprogramma nog bevatten.
Voor een beginnende brouwer zijn sommige kronkels in brouwhulp totaal ondoorgrondbaar (wat niet zelden tot fouten leidt)

Tav handleiding, ik heb ooit gedurende 10 jaar de documentatie voor de Raytracer POV-Ray geschreven en beheerd, zo'n 700 pagina's tekst. Het gevaar is al snel het een handleiding voor brouwhulp een boek over (hobby)brouwen wordt. Lastige klus.

volledig met je eens, een handleiding wordt al rap een cursus brouwen.
daarom heb ik besloten om zelf een excel documentje aan te maken met berekeningsregeltjes op de achtergrond (van de (voor mij) meest belangrijke, nl. kleur, bitterheid, alc%, vergistingsgraad en aantal g CO2 in flesje).
Het gaat er vooral om dat je ongeveer weet waarmee je bezig bent. Bij problemen zijn er tal van hulpmiddelen (dit forum, www, professionele brouwers,...) Ik heb een aantal keer brouwhulp, eroica geprobeerd maar al snel het voor bekeken gehouden omdat je nooit weet welke parameters wat doen.
Er zijn sowieso veeeeeel te veel variabelen bij het hobbybrouwen waardoor een brouwsel een uniek gegeven wordt dat je toch nooit 2x perfect kan brouwen. Ik denk maar aan omgevingstemperatuur (zomer/winter), watertemperatuur, bewaartemperatuur van de mout, maischschema (5 minuten langer of korter op een bepaalde temperatuur is al een wereld van verschil), tijd nodig om op kooktemperatuur te geraken, hevigheid van koken, ......
dus als hobbybrouwer gaat het vooral om een lekker eigen biertje te maken om met vrienden nadien te degusteren vind ik
Zo'n handleiding kan je ook via Youtube maken. Gewoon enkele video's over hoe je een recept opstelt, je brouwerij ingeeft, grondstoffen toevoegt en een brouwsessie opstart. Hoeft niks ingewikkelds te zijn maar het geeft de gebruiker wel de kans om aan de slag te gaan met de software.
Daarnaast zou ik ook een hulplijn openhouden die makkelijk bereikbaar is voor geïnteresseerden. Brewfather doet dit via een Facebook groep waar je vragen kan stellen en nieuwe features kan aanvragen (je wordt dan wel doorverwezen naar hun Github).
Voor wat inspiratie is hier een filmpje van Brewfather met instructies :
Brewfather - Introduction and Walkthrough - English