Gerard van der Pol

48 punten

Developer Technical Specialist at Microsoft

3stemmen

Cloud | Desktop | Phone | Web

Artikel: 29 juni 2011

Je eigen artikel in .NET Magazine

925 views - Download: PDF

Gerard van der Pol

.NET Magazine bestaat al de nodige jaren en heeft, naast een grote groep lezers, ook een grote groep auteurs, die verantwoordelijk is voor het schrijven van de artikelen die elke drie maanden in het blad gepubliceerd worden. Kenmerkend voor .NET Magazine is dat een zeer groot deel van deze auteurs uit de .NET community voortkomt.

In de huidige redactie workflow van .Net Magazine dient een auteur een suggestie voor een artikel in middels een abstract, waarin de strekking van het beoogde artikel wordt toegelicht. Na goedkeuring van dit abstract gaat de auteur aan de slag om het idee om te zetten in een artikel. Tot nu toe is het de gewoonte het artikel in Microsoft Word aan te leveren. Na een review van de redactie wordt het artikel in zijn layout gehesen voor publicatie in het blad en gaat de content op weg naar de drukker.

Elke drie maanden krijgt iedere lezer van het blad het eind resultaat van dit proces onder ogen op het moment dat het blad op de deurmat valt. Sinds vorig jaar worden deze artikelen ook online gepubliceerd op .NET Magazine. Om meer mensen de mogelijkheid te bieden een artikel te schrijven voor het magazine, heeft .NET Magazine nu online mogelijkheden om een artikel te schrijven. Heb je altijd al je eigen artikel in .NET Magazine willen hebben, lees dan vooral verder.

De nieuwe functionaliteit op .NET Magazine is erop gericht om de auteur en de redactie beter te ondersteunen gedurende het gehele proces vanaf het indienen van de abstract tot aan de publicatie. Een van de voordelen is dat zowel auteur als redactie continue op de hoogte van de status van een artikel zijn. Deze functionaliteit is beschikbaar voor iedere geregistreerde lezer van het online .NET magazine.

Starten met een artikel

Om een artikel te schrijven voor het Magazine moet je je eerst registeren op .NET Magazine.

Afbeelding 1. Na inloggen is de Mijn Artikelen link beschikbaar

Na inloggen kan je middels de Mijn artikelen link een abstract indienen voor een nieuw artikel.

Afbeelding 2. Indienen van een abstract

Werken aan je artikel

Een groot aantal van de gepubliceerde artikelen in .NET Magazine hebben een identieke structuur. Een artikel bestaat over het algemeen uit drie delen, namelijk een introductie waarin de probleemstelling kort wordt toegelicht, de body waarin de oplossing wordt uitgewerkt, en het artikel wordt afgesloten met een conclusie van de auteur waarin vaak ook een opsomming van interessante referenties te vinden is. Deze structuur is bepalend geweest voor het ontwikkelen van de online functionaliteit. Om een artikel verder uit te werken worden bouwstenen aangeboden, waarmee een auteur snel de outline van een artikel kan opzetten. In afbeelding 4 zijn de tabbladen voor de drie delen van het artikel zichtbaar.

Afbeelding 3. Enkele artikel bouwstenen

Er zijn bouwstenen voor het toevoegen van een introductie, paragraaf, afbeelding, source code, opsomming, referentielijst en tabel aan een artikel. Er zijn ook bouwstenen voor het toevoegen van een channel9 of youtube video, heel nuttig om bepaalde aspecten op een andere manier toe te lichten. Deze laatste bouwstenen kunnen we natuurlijk niet opnemen in het gedrukte versie van .NET Magazine, dus gebruik blijft voorbehouden aan een online artikel. De bouwstenen bevatten niet alleen de inhoud, maar tevens ook de nodige metadata en worden in het traject ook gebruikt voor het reviewen van het artikel.

Waarom is er gekozen om een artikel samen te stellen uit bouwstenen in plaats van een editor aan te bieden om het gehele artikel mee te schrijven? Deze werkwijze heeft als voordeel dat we opmaak en inhoud kunnen scheiden en een uniforme look en feel over de website kunnen realiseren. Daarnaast kunnen we het artikel gemakkelijk publiceren in zowel het gedrukte blad als ook online. Het uitwerken van een artikel is zeker niet minder visueel, zoals in afbeelding 4 in te zien. De blokken kunnen worden ingeklapt waarmee de outline van het artikel zichtbaar wordt, de blokken laten zich ook gemakkelijk bewerken en ook de volgorde kan middels drag en drop simpel worden aangepast.

Afbeelding 4. Werken aan het artikel

In afbeelding 4 zien we een deel van de body van een voorbeeld artikel. We zien dat er, naast een afbeelding, een aantal paragrafen zijn toegevoegd. Een aantal van deze paragrafen zijn ingeklapt waardoor de inhoud hiervan niet zichtbaar is. Elke bouwsteen heeft rechts bovenin de functionaliteit om het te bewerken, verwijderen, minimaliseren of maximaliseren.
Elke bouwsteen heeft zijn eigen karakter, zo heeft de bouwsteen om source code toe te voegen een property om de programmeer taal in kwestie te specifieren, dit wordt onder andere gebruikt om syntax highlighting toe te voegen. Op dit moment ondersteunen syntax highlighting voor C#, VB.NET, Javascript, XML en SQL.

De redactie workflow

De lifecycle van een artikel start met status ‘Nieuw’. Een auteur kan in deze fase van de lifecycle zijn idee uitwerken en zodra gereed indienen bij de redactie. De status van het artikel verandert nu in ‘Abstract’. De redactie zal het idee beoordelen en de auteur feedback geven rondom de richting van het artikel. Een geaccepteerd abstract zal nu de status ‘Draft’ krijgen. Vanaf dit moment kan de auteur inhoudelijk aan de slag, de online functionaliteit bied de auteur het nodige om zijn idee verder uit te werken. We zullen dit verder in dit artikel nader toelichten. De auteur zal na afronden van de draft fase zijn artikel ter review aanbieden. De auteur zal de eventuele feedback uit de review fase verwerken totdat de redactie het artikel accepteerd en het gereed gemaakt kan worden voor publicatie.

Het magazine verschijnt elke drie maanden en is daarmee, tot op heden, bepalend geweest voor het aantal artikelen wat we kunnen publiceren. Dit gaat echter veranderen, het blad zal nog steeds het drie maandelijkse uitgavepatroon volgen, echter voor de online versie van .NET Magazine willen we de frequentie waarmee we artikelen publiceren verhogen. We zijn dus op zoek naar auteurs die een artikel willen schrijven voor .NET Magazine om hun kennis en enthousiasme met duizenden andere ontwikkelaars te delen. Een redactieteam en ervaren auteurs uit de .NET community staan paraat om je te ondersteunen bij het schrijven en reviewen van je artikel. Goedgekeurde artikelen worden gepubliceerd op de portal van .NET Magazine en maken kans op publicatie in het gedrukte .NET Magazine.

Waarover kan ik schrijven?

Er zijn voldoende onderwerpen waarvoor we artikelen zoeken, denk hierbij aan features, extensies en best practices rondom Visual Studio, Visual Studio Lightswitch, Expression Blend, Team Foundation Server, Microsoft Test Manager, BizTalk, SQL Server, Project Orchard, Silverlight, Web Matrix, IIS Express, SQL Express, Web Platform Installer (WEB PI), ASP.NET MVC 3, Razor, NUGet, Internet Explorer 9 voor developers, HTML 5, Windows Phone, Windows Azure, Entity Framework, OData, etc.

Heb je interesse om voor .NET Magazine te schrijven, stuur dan je abstract op. Heb je nog vragen, neem gerust contact met me op, mijn email staat onder dit artikel vermeld.