If you are an English-speaking person who is interested in writing for the SDN, please look here.
Als je geïnteresseerd bent om een artikel (of wellicht meer dan 1) met onze leden te delen of liever eerst meer informatie wilt ontvangen,aarzel dan a.u.b. niet om contact met ons op te nemen (via email naar redactie at sdn dot nl).
Voor meer informatie kun je uiteraard ook een bezoek brengen aan onze website www.sdn.nl en indien gewenst kunnen we je een recent exemplaar van ons magazine toesturen.
Onderwerpen
Het SDN is altijd op zoek naar artikelen met nuttige informatie voor de leden. We streven ernaar om zoveel mogelijk nieuw materiaal te plaatsen, en dus herplaatsing van bestaande artikelen te beperken, maar dit is geen wet van Meden en Perzen. Het belangrijkste is dat een artikel voldoende informatief en actueel is.
Artikelen kunnen zich richten op zowel beginnende als (ver) gevorderde ontwikkelaars. Te denken valt aan de volgende onderwerpen:
- Grondbeginselen voor beginners
- Diepgaande kennis voor/door gevorderden
- Succesverhalen en best practices (incl. de valkuilen)
- Standaarden en richtlijnen, ontwikkeltechnieken, software architecturen
- Productbesprekingen
En zo zijn er natuurlijk nog vele andere onderwerpen te bedenken. Vaak zijn vragen waar je zelf mee geworsteld hebt zeer interessant voor de lezers, dus als je die kennis en informatie met ze wilt delen ...
Naast volledige artikelen zijn ook boekbesprekingen, columns, tips & trucs, enz., van harte welkom.
Opbouw
Een artikel dient een logische opbouw te hebben:
- Een korte inleiding waarbij het onderwerp of probleem wordt aangegeven
- Gevolgd door een verdere uitwerking van het verhaal
- En tenslotte een samenvatting met conclusies, waarbij b.v. pro's en con's van de besproken oplossingen aan de orde kunnen komen
Artikelen kunnen uiteraard en graag zelfs - voorzien worden van code-listings (altijd erg handig om min of meer theoretische punten toe te lichten) en afbeeldingen (a picture is worth a 1000 words).
Het SDN heeft een auteurs-pack beschikbaar waarin deze richtlijnen vertaald zijn naar een praktische opzet, die daarmee kan dienen als uitgangspunt voor het artikel. Dat maakt het voor jou (en voor ons) wat makkelijker; vandaar de vraag of je het ingesloten sjabloon wilt gebruiken.
Tips
- Zorg dat je artikel een logische, heldere volgorde heeft, ga uit van een heldere inleiding en werk het artikel vervolgens stap voor stap uit. Het gebruik maken van outlines kan erg behulpzaam zijn bij het maken van je artikel. Gebruik regelmatig een tussenkop bij een nieuw (sub)onderdeel.
- Schrijf over iets nieuws of over iets anders. Nieuwe onderwerpen worden zeer gewaardeerd. De lezers stellen informatie die zij direct kunnen gebruiken in hun eigen projecten zeer op prijs. Stel je daarom zelf de vragen die een journalist ook zou stellen: wie, wat, waar, waarom en hoe?
- Vermijd extremen. Schrijf op een normale, vriendelijke en enthousiaste wijze. Je artikel moet gemakkelijk door iedereen te begrijpen zijn. Houd spreektaal aan als richtlijn. Een goed hulpmiddel is het artikel zelf hardop oplezen. Niet 'lopende' delen zijn zo eenvoudig te herkennen.
- Hanteer de zeven stijlregels:
- Eenvoud: vermijd lange zinnen en lastige zinsconstructies en gebruik geen moeilijke woorden; hou voortdurend rekening met je lezers, etc
- Nauwkeurigheid: voorkom vaag woordgebruik; gebruik concrete referenties; woorden zoals die, dat, zij en het moeten eenduidig naar iets verwijzen, etc
- Bondigheid: formuleer zonder veel omhaal van woorden; pak de koe bij de horens, m.a.w. draai er niet omheen en wees specifiek, etc
- Levendigheid: gebruik de directe vorm, gebruik geen lijdende vorm of verleden tijd, varieer in woordkeuze voor hetzelfde begrip; gebruik de ik-vorm in je artikel om de lezer betrokken te houden, etc
- Foutloos: controleer je feiten (onjuistheden zullen worden herkend door de lezers!; maak je niet (al te) druk om spelfouten (die haalt de redactie er wel uit), etc
- Zuiverheid: vermijd te veel buitenlandse woorden; hanteer echter wel de gangbare Engelse uitdrukkingen in softwareontwikkeling. etc
- Verzorgdheid: vermijd slordigheid in interpuncties, wees consistent in spelling en in hoofd- en kleine letter. etc
Kortom: Beschouw de lezer als een gast...
Voorbeeldcode:
Het streven van de redactie is om de code goed in het artikel te krijgen, zodat deze met knippen en plakken vanuit de (website-)versie van het artikel rechtsreeks bruikbaar zou moeten zijn voor de lezer. Daarom hanteren we de volgende richtlijnen:
- Voorzie de code van commentaar daar waar nodig.
- Zorg zelf dat de code werkt. Vraag een collega om er ook even naar te kijken.
- Gebruik de term listing voor een codevoorbeelden en verwijs in de tekst naar de listing m.b.v een nummer. Dus niet "zie codevoorbeeld hieronder" maar "zie listing 3".
Deze regel geldt overigens ook voor verwijzingen naar illustraties zoals screenshots en schema's..
- Belangrijk is dat code op een pagina past; dit geldt ook voor een webpagina! Maak de code daarom niet breder dan 70 tekens.
NB: Als het artikel ook in het magazine verschijnt, geldt een regellengte van 57 tekens!
- Breek de code zelf af, en op de juiste manier binnen de taal waar de code voor geschreven wordt. Doe dat op een logische plaats en op een consistente manier.
- Gebruik 2 spaties voor het inspringen per niveau.
PS: Dit is geen waardeoordeel, maar een praktische afspraak om de lezer zoveel mogelijk code op een regel te kunnen laten zien en op een consistente manier.
Plaatjes en screenshots
- Lever het artikel aan met de afbeeldingen opgenomen in het artikel, maar lever s.v.p. ook de afbeeldingen los aan!
- Lever plaatjes/screenshots s.v.p. aan in een zo hoog mogelijke resolutie, en liever BMP dan JPG. Downsizen kan altijd nog, upsizen is lastiger.
- Plaatjes zeggen meer dan 1000 woorden, ze geven een artikel kleur en maken de pagina minder saai. Probeer echter een maximum van 2 illustraties per (A4) pagina te hanteren.
- Verwijs in de tekst naar plaatjes via "zie figuur 3" in plaats van "zie de figuur hieronder".
Aanlevering
Aanlevering van (een reeks van) artikel(en) verloopt via één van de SDN organisatieleden die betrokken is bij het network waarop uw artikel (het meeste) betrekking heeft. Vaak zal hij/zij ook het initiële contact met je gelegd hebben, en deze persoon zal het artikel inhoudelijk beoordelen op aspecten als duidelijkheid, correctheid, diepgang, enz. Indien nodig, neemt hij met je contact op over evt. aanpassingen.
Plaatsing
Plaatsing vindt in principe op de website van het SDN (www.sdn.nl) plaats. Het artikel kan daarbij eventueel in (logische) delen opgesplitst en gepubliceerd worden, zulks naar beoordeling van het SDN.
Een beperkt deel van de artikelen verschijnt ook in het SDN magazine, dat 4x per jaar wordt uitgegeven voor de SDN leden.
De maximale omvang van een boekbespreking is 800 woorden. Voor columns geniet een afspraak op (half)jaar-basis de voorkeur.
Copyright
Het SDN vereist geen exclusiviteit van plaatsing van artikelen, of legt anderszins belemmeringen op aan auteurs m.b.t. het elders publiceren van artikelen. Wel streeft het SDN ernaar om zoveel mogelijk nieuw materiaal te plaatsen, en dus herplaatsing van bestaande artikelen te beperken.
Als auteur dien je zelf expliciet na te gaan en - indien van toepassing - aan te geven of er beperkingen van kracht zijn m.b.t. (her)plaatsing van artikelen. Als dit ten onrechte nagelaten blijkt te zijn, zal het SDN niet aansprakelijk zijn voor eventuele gevolgen daarvan.