Stap 5: Algemene schrijfstijl
Dit advies gaat vooral aan al mijn vrienden daar met engineering graden. Wanneer u een bepaalde set terminologie dagelijks gebruiken bij uw werk (of elke avond/weekend bent u een ervaren hobbyist), wordt het tweede natuur. U kunt woorden, zinnen en acroniemen zonder een tweede gedachte te geven aan het idee dat mensen buiten uw beroep misschien niet weten wat je bedoelt. Dat kan grote werk voor het communiceren met uw collega's, maar het is niet een grote aanpak voor Instructables. Het grote ding over het verkeer van de maker is dat het moedigt iedereen te gaan maken stuff - en "iedereen" omvat kinderen jong genoeg dat ze niet ooit gehad een natuurkunde klasse (laat staan een cursus Elektrotechniek), of volwassenen die nam hoge school natuurkunde decennia geleden en heb niet aangeraakt sinds. Dat betekent dat een groot deel van uw doelgroep kan bestaan uit mensen die zero vertrouwdheid met dingen die je boter hebben overwegen, zoals het toevoegen van waarden van de weerstand in serie of de voorwaartse spanningsval over een LED. Zelfs als u een lijst met gedetailleerde materialen, professionele kwaliteit foto's en Super duidelijke stapsgewijze breadboard diagrammen hebt, kan u nog steeds laten iemand gewoon blindelings na uw montage-instructies zonder echt te begrijpen wat er gaande is. Het schrijven verbindt het allemaal samen - en als je in sommige extra inspanning, kunt u echt maken uw Instructable groot.
Betekent dat u moet schrijven een stap opnieuw het verklaren van de wet van Ohm in elke één van uw projecten? Natuurlijk niet - vindt als u probeert om alle te leggen van de basis om ongetrouwd tijd, je jezelf schrijven een hele elektrotechniek leerboek van nul. Er zijn echter een paar dingen die je kunt doen:
- Acroniemen en jargon uitleggen! Niet iedereen weet het verschil tussen NPNs en PNPs of BJTs en FETs of herkent dat IC u verwijst tot slechts door het modelnummer (555 timer iedereen?). Zie hoe ik enkel mijn eigen regel er geschonden? Stel je voor hoe verwarrend dit opsommingsteken kijkt naar iemand die niet weet wat een van die dingen zijn. Je zou kunnen zeggen tegen jezelf: "onzin! Iedereen weet dat de IC voor geïntegreerde schakeling staat!"of" als ze niet weten, ze kunnen enkel Google het! "of"echt? Wie heeft niet gehoord van een 555 timer?" Maar vergeet niet - we praten over hoe kan je boven en buiten de normale call of duty voor het schrijven van een Instructable. Stoppen na te denken over of u weten zou wat om het even welk van die dingen bedoeld als je 12 jaar oud was, of als u noemde hen in een gesprek met je grootouders op Thanksgiving diner. Wilt u uw project toegankelijk maken voor zoveel mensen als mogelijk? Vervolgens nemen de extra paar seconden "geïntegreerde circuit (IC)" typt in plaats van gewoon "IC", of een link naar het Wikipedia-artikel 555 timervoorzien. Die stijl van schrijven en het verstrekken van verwijzingen zal uw project vriendelijker en toegankelijker maken voor beginners, die misschien anders intimideren door de muur van acroniemen en nummers die ze niet begrijpen.
- Lezers geven een idee van welke concepten die zij zich met vertrouwd maken moeten als ze willen begrijpen hoe uw project werkt. Zeker, moet u wellicht sommige mensen die gewoon blindelings volgen een breadboard diagram en niet schelen wat er gaande is binnen het circuit; maar je hebt ook mensen die echt nieuwsgierig naar wat gaande is er, en worden geïntimideerd of verward over waar te beginnen. Ze zou niet eens weten wat vragen te stellen of wat ze moeten Google. Dus nogmaals, u hoeft niet te schrijven van uw eigen pagina uitleg van de wet van Ohm of wat een condensator is elke keer - maar je zou kunnen geven een korte uitleg en bieden een nuttige link: "als u weten hoe de schakeling werkt wilt, je zal moeten begrijpen van spanning, stroom, weerstand en de vergelijking die betrekking heeft op hen, die de wet van Ohm heet. U kunt meer lezen over de wet van Ohm op deze geweldige SparkFun referentie. " Een ander paar extra seconden van werk van uw kant, maar een wereld van hulp aan een beginner aan de slag op de goede weg.
Voor de goede orde heeft SparkFun een hele deel van hun site boordevol tutorials en handleidingen, net zoals Adafruit. Er zijn ook enkele goede Instructables referenties zoals elementaire elektronica door randofo. Ik vind dat Wikipedia-artikelen zijn meestal een beetje zwaar op technische taal - dus terwijl ze misschien wel een goede snelle referentie voor "wat is dit ding," ze zijn niet de beste plaats voor een beginner-vriendelijke uitleg. Als u niet kunt wat u zoekt meteen vinden, besteden een beetje tijd Googlen voor een goede beginner-friendly-bron. Uw lezers zullen u bedanken.