Vertaald van : Wiki: What Makes a Great Wiki Article (en-US)



Er zijn vele manieren om een Wiki artikel te schrijven . Dit onderwerp beschrijft wat het beste werkt in Wiki's zoals deze.

Als je een een artikel post, klik op de koppeling rechts of Klik hier.
Om ideeën te vinden om een artikel te schrijven, Klik hier  .

Hoe maak je een geweldig Wiki artikel

Een geweldig Wiki artikel biedt een of meer stukjes van informatie die de lezer nodig heeft gebaseerd op de titel en de eerste alinea. Als je belooft om te beschrijven hoe een bepaalde functie in een bepaalde omgeving te implementeren, moet je artikel bondig en beknopt de omgeving en de voorwaarden beschrijven, net als de stappen en de eind toestand met diagrammen, video's en andere ondersteunend materiaal zoals nodig zodat de lezer de taak kan voltooien.

Om een geweldig Wiki artikel te schrijven, zal je best

  •  één of twee belangrijke kernpunten identificeren over informatie je wil delen.
  • Leg de basis voor 't kernpunt in de titel: hoe werkwoord de <kernpunt>, <kernpunt> problemen oplossen, <nugget> verbinden met < andere product >,  aan de slag met <kernpunt>, enz.
  • Stel de verwachtingen in voor het artikel in de eerste alinea . Zal je door een installatie van SQL Server 2008 lopen in een geclusterde omgeving met behulp van een cluster van 64 bit machines, met een beschrijving van de bijzonderheden van interop tussen twee functies, de voor- en nadelen van een API-functie oproepen tegenover een andere probleemoplossing verstrekken voor een product of functie, of bespreking van de algemene eigenschappen van een bepaalde implementatie?
  • Lezers willen weten wat te verwachten.
  • Bondig schrijven. Langere artikelen zijn niet altijd betere artikelen. Als je informatie in 20 woorden kan bieden, dan is 20 woorden genoeg.
  • Gebruik maken van je eigen stijl, maar niet ten koste van de duidelijkheid. We zijn geen robots. Gebruik je eigen stijl, maar laat het niet in de weg staan van wat je probeert te zeggen . Bescherm het kernpunt van de informatie!
  • Gebruik trefwoorden over het kernpunt in de titel en de hoofdtekst. Geen opgesmukte zoekmachine optimizatie , gewoon weten je zoekwoorden zijn en ze gebruiken. Bijvoorbeeld, zorg ervoor dat de taak en de technologie, hulpprogramma of functie naam vermeld worden. Indien nodig voor de duidelijkheid, vermeld het product of de versie van het product.
  • Referenties bepalen waar nodig. Referenties bieden geloofwaardigheid, autoriteit, alternatieve weergaven,  bijkomende waarde, en vaak verhogen ze de reputatie van het artikel.
  • Heb een een eigen mening en verkondig die. Als je liever een specifieke implementatieoplossing hebt, beschrijf de alternatieven die je onderzocht en waarom je hebben de voorkeur. Als een manier van aanroepen van een API-functie boven de andere? Vertel ons waarom! Vertel ons over de dingen die je geprobeerd hebt die niet werkten. Het lijkt misschien triviaal, maar wij, de lezers, willen weten.
  • Vragen voor de gewenste help. Als je wilt dat mensen meer scenario's, scripts of andere informatie toe te voegen, laat het ze weten.
  • Draag moedig bij, bewerk voorzichtigje mag de schrijver zijn van het artikel, maar zodra gepubliceerd is de Wiki community eigenaar van het artikel. Als de spelling- en grammaticacontrole niet perfect zijn, zal de Wiki community uiteindelijk helpen en verbeteren waar nodig.
  • Verbind het artikel. In voorkomend geval, link van en naar je artikel voor gemakkelijke toegang. Bijvoorbeeld:
    • Link naar het artikel van je blog of externe site.
    • Link het artikel aan de ondersteuning van belangrijke inhoud in de Technet Library  , elders op Microsoft.com of op externe sites.

Als je een behoefte opvult, zullen lezers je artikel vinden.

Soorten artikels

Je artikel kan vele verschillende types van behoeften vullen . Hier zijn een paar soorten behoeften die je zou kunnen vinden:

  • Discussie. Dit type van artikel presenteert verschillende opties, adviezen en standpunten. Als lezers niet eens zijn met sommige punten, dan ze hun eigen gedachten en overwegingen als een "alternatieve opinie" aan de bestaande adviezen toevoegen. Het doel is om alle inzichten duidelijk te presenteren. Voorbeelden.
  • Algemeen overzicht. Het doel is om een basisoverzicht te leveren van een product, theorie, of algemene concept. Als grote subsecties ontstaan, start een nieuw artikel en link naar het eerste. Voorbeelden.
  • Hoe te. Dit type van artikel presenteert instructies die zo helder en zo simpel als mogelijk zijn. Voorbeeld: het toevoegen van een Video- of afbeeldingsbestanden.
  • Stub. Een kort artikel dat uitbreiding nodig zal hebben. Creeer een begin. Misschien heb je niet de tijd of kennis om het volledige artikel te schrijven, maar je hoopt om het later te voltooien of dat de Wiki community het voltooit . Voorbeelden.
  • Link collectie. Een artikel dat is meestal een verzameling van links. Dit zou een Wiki portaal (waar alle koppelingen verwijzen naar andere onderwerpen in de TechNet Wiki) of een collectie van alle externe links (of een combinatie). Zorg ervoor dat het duidelijk is dat het al of niet de links zijn naar andere Wiki-artikelen. Voorbeelden: aan de slag, lijst van producten en verwante onderwerpen.
  • Oplossen. Een lijst van oplossingen voor veelvoorkomende problemen bij het interactief werken met een specifieke product of interface. Voorbeelden.

Zie ook

Andere talen

Dit artikel is ook beschikbaar de volgende talen: