Integrera 11 kraftfulla verktyg för bästa produktdokumentation i klassen

Avatar of Author
Ciaran Sweet
on July 28, 2021 · · filed under Product Documentation Documentation Portals Best Practices Technical Writing Product Documentation Tutorials

Produktteamen måste skapa en fantastisk produktdokumentation för att kunna leverera bästa möjliga kundupplevelser. Dokumentationen i sig är som ett uppslagsverk för företagsprodukter; ju mer exakt och lättläst den är, desto lättare är det för dina kunder att förstå din produkt och få ut värde.

Docsie är en kraftfull lösning för dokumentationshantering som direkt riktar sig till dessa behov. Skribenter kan skapa produktdokumentation, redigera dokumentation och publicera dokumentation på webben med några få tryck på tangentbordet och några enkla klick. Resultatet är centraliserad, tillgänglig produktdokumentation med organisation, global sökning, sammanställning av feedback och stöd för rika medier.

Vi vill inte erkänna det, men... Docsie kan inte göra allt... Det finns dock utmärkta verktyg där ute som Docsie-användare kan integrera i sitt arbetsflöde. Dessa verktyg hjälper oss att skapa produktdokumentation, och vi bjuder in dig att prova dem i Docsie med vår [free forever Startup plan] (https://www.docsie.io/pricing/)!

Låt oss börja skriva!

Höj nivån på din Docsie-upplevelse med 11 kraftfulla verktyg

1. Proffsig skrivhjälp

Först har vi Pro Writing Aid. Detta är ett verktyg för grammatik, stavning och meningsstrukturering som hjälper skribenter att skapa produktdokumentation.

Om det är osannolikt att du kommer ihåg "you're" vs "your" när du skriver, fångar det här verktyget upp fel och ger kontextuella rekommendationer i farten.

Det kan också ge en läsårsnivå (t.ex. årskurs 13), övervakning av meningsvariationer (korta meningar följt av långa meningar) och passiv röst ("Jag kommer att göra arbetet" vs "Arbetet kommer att göras av mig").

Grammatik, stavning och meningsstrukturering är viktigare än vad många tror. När en kund ser dålig grammatik, stavfel och långa stycken meningar - då förlorar han eller hon förtroendet för din produkt. Till exempel är en hög läsnivå för en produkt som riktar sig till barn kontraproduktiv. Passiv röst tenderar att slösa bort skärmutrymme och känns rundhänt för läsarna, medan aktiv röst är kort, snygg och rakt på sak.

Lägg till Pro Writing Aid i ditt Docsie-arbetsflöde; förbättra dina ord, inspirera dina kunder.

2. QuillBot

Parafrasering är en vanlig metod vid innehållsutveckling, och det gäller även när du skapar produktdokumentation. Hur mycket vi än vill tro det var vi tyvärr inte de första som fick den idén och satte pennan på papper!

Parafrasering är så enkelt som att säga samma sak med andra ord. QuillBot är ett AI-programvaruverktyg som automatiskt parafraserar åt dig och undviker plagiat och dess ryktes- eller upphovsrättsrelaterade konsekvenser.

"Hur går man tillväga för att parafrasera?"

Skriv bara din mening, klicka på "Omformulera" och ett parafraserat utdrag visas på höger sida. Snyggt, eller hur?

Överväg att ge QuillBot ett försök tillsammans med Docsie om du återanvänder innehåll på internet. Vi rekommenderar alltid att du är originell, QuillBot är helt enkelt ett verktyg som automatiserar originaliteten.

3. Snagit

Produktdokumentation består inte bara av ord utan behöver bilder och konstverk för att illustrera hela bilden (med ordvitsar). Genom att tillhandahålla steg-för-steg-instruktioner med tillhörande bilder får användarna större säkerhet och förtroende när de följer användarproduktguider.

I Windows finns [Snipping Tool] (https://support.microsoft.com/en-us/windows/use-snipping-tool-to-capture-screenshots-00246869-1843-655f-f220-97299b865f6b) tillgängligt. För Linux kan skärmdumpar tas med hjälp av (Shift/Alt)+PrintScreen-tangentbordsgenvägar. På macOS görs detta med Shift+Command+5. Funktionaliteten är dock begränsad.

Nästa på vår lista över verktyg för programvarudokumentation är Snagit. Det går ett steg längre som ett allt-i-ett-verktyg för skärmdumpning. Användare kan ta skärmdumpar från hela skärmen, skärmdumpar från fönster eller rita en skärmdumpsfångstzon. Snagit kan också ta video- och röstinspelningar, till exempel via en webbkamera. Det bästa är dess redigeringsfunktionalitet, som möjliggör anteckningar som pilar och text i skärmdumpar, eller beskärning och ljudöverlagring för GIF:er och video.

Enkelt uttryckt är Snagit en lösning för skärmdumpar, videoredigering och kommunikation som är byggd för skribenter av produktdokumentation. Överväg att ge det ett försök nästa gång du behöver bilder till dina Docsie Books!

4. Camtasia

Från skaparna av Snagit (är det här en filmtrailer?) - härnäst har vi Camtasia!

Camtasia liknar Snagit, men fokuserar på skärminspelning och videoredigering. Användarna kan dra nytta av videomallar med övergångar och moderna stilar och dela mallar med teamet för att effektivisera arbetsflöden för videoskapande. Det royaltyfria Camtasia-tillgångsbiblioteket ger visuell stil utan upphovsrättslig börda. I likhet med Snagit stöder Camtasia anteckningar, enhetsinramning (helskärm, fönsterformat, rita ett område) och ljudinspelning med dubbla ingångar (både mikrofon och systemljud).

Camtasia på YouTube är så 2008, men det är inte för sent att börja använda det här verktyget för att skapa produktdokumentation i Docsie. Ge dina dokument lite boom boom pow!

5. Tableau

Data får verkligen den moderna världen att gå runt! Rå data är dock svåra att förstå för människor. Datorer hanterar rådata hela tiden.

Tableau tar rådata och omvandlar den till vackra visualiseringar, vilket gör det lättare för alla målgrupper att se och tolka mönster, trender och andra datainsikter. Den stöder ett stort antal databastyper, inklusive relationsdatabaser (RDBMS), icke-relationella databaser (non-RDBMS) och objektorienterade databaser (OODBMS) - vilket leder till praktiskt taget obegränsad potential för datavisualisering.

Här är ett exempel på Tableau-visualisering som är inbäddad i en Docsie Book.

Testa den här visualiseringen själv! Öppna Docsie, skapa produktdokumentation (en Book) och välj knappen Embed (bädda in) i Docsie Editor. Klistra in inbäddningskoden och ändra storlek så att den passar din webbsida (attribut vizElement.style.width och vizElement.style.height).

Inbäddningskod (klistra in mig!)

Om din produktdokumentation använder statistik och data kan du göra det enklare (och snyggare) för användarna genom att använda Tableau. Docsie stöder inbäddning av Tableau med hjälp av iFrame-teknik, så ge det ett försök!

6. Draw.io

En elektriker försöker aldrig att dra om elektriska kablar utan en schematisk ritning eller ett diagram. Med detta i åtanke kan användarna snabbare lära sig hur din produkt fungerar när du tillhandahåller diagram och flödesscheman.

Författare av produktdokumentation kan använda Draw.io för att skapa flödesscheman och diagram. Det här verktyget för programvarudokumentation tillhandahåller mallar och hundratals tillgångar för att skapa engagerande, visuellt tilltalande diagram. När det gäller datorsystem och nätverkstopologi kan diagram och flödesscheman till exempel förklara systemhierarkin och dataflödet. Gör detsamma för dina produkter genom att förklara underliggande arbetsflöden och funktionalitet.

Draw.io är ett annat verktyg som stöder inbäddning av iFrames. Skapa produktdokumentation och bädda sedan in den direkt i din Docsie-dokumentation! Alternativt kan du ta en skärmdump med verktyg som Snagit, men vi rekommenderar iFrame eftersom ändringar i diagrammet sprids automatiskt.

7. Statista

Statistik ökar auktoriteten i dokumentationen. Om du vill inkludera statistik kan du prova Statista när du nästa gång skapar produktdokumentation för jämförelser med konkurrenter, för att illustrera marknadsförhållandena och hur dina produkter hanterar dem, eller bara för att lägga till lite mer kraft!

Statista samlar in data inom 170 branscher i över 150 länder, vilket gör det till en av de bästa digitala källorna för statistiska data. All data backas upp av kollegialt granskade studier, och vissa datagram visar till och med projektioner och prognoser.

Statista är bra eftersom den stöder iFrame embedding, vilket gör att du kan bädda in grafer och diagram i din Docsie-dokumentation. Dessa grafer och diagram uppdateras med tiden, vilket gör att din statistik förblir ständigt aktuell!

Skapa ett Statista-konto och prova att bädda in statistik i din nästa Docsie-bok!

8. CodePen.io

Dokumentation av mjukvaruprodukter är en annan sak än fysiska produkter. Den innehåller teknisk information på hög nivå, kodutdrag och beroenden - särskilt när den riktar sig till utvecklare eller ingenjörer och inte till lekmän.

En skärmdump av JavaScript-kod ger dock inte mycket till utvecklare och ingenjörer som läser din dokumentation. Du kan inte Ctrl+C-kod om den finns i en bild! Vad de behöver är en sandlåda för kod i front-end med funktioner för att bygga, testa och dela kod.

I ett hav av verktyg för programvarudokumentation är CodePen.io särskilt bra för att utföra och illustrera sandboxad kod.

Kod i CodePen körs i realtid på sidan och visar exakt vad din kod gör för användarna. Detta är utmärkt om din produkt stöder anpassad kod, eftersom du kan dela med dig av ett bibliotek med mallad funktionalitet som användarna kan ta del av. Slutligen uppmuntrar sandlådemiljön till experimenterande och inspirerar användarna att prova nya saker och fullt ut utforska gränserna för din produkt.

Inbäddningskod (klistra in mig!)

Prova CodePen.io-inbäddning i Docsie, och dra nytta av vår funktion för kodmarkering för att hjälpa dina utvecklare att göra mer med dina dokument!

9. Doxygen

Ett mindre känt verktyg, men användbart för utvecklare och författare av programvarudokumentation. Doxygen (inte relaterat till Docsie!) skapar automatiskt programvarudokumentation genom att skanna igenom kod och identifiera parametrar, attribut, kommentarer med mera.

Ett tillägg för Doxygen är CLion, som gör det möjligt att visa Doxygen-dokumentationsutgångar i realtid i kodredigeringsvyn.

Här är ett exempel på hur man utforskar [iTunes COM Interface] (http://www.joshkunz.com/iTunesControl/). Ange källkoden och dokumentationen skriver sig själv!

Prova att använda Doxygen och kopiera resultaten till Docsie. Sedan kan du använda vårt plugin för kodmarkering och andra formateringsalternativ!

10. Pixlr E

Vi'har redan utforskat hur man tar bilder med Snagit. Det som saknas är ett kraftfullt sätt att redigera bilder på dator och mobil. Adobe Photoshop är kraftfullt, men hårdvarukraven och licenskostnaderna begränsar dess användning till designers, konstnärer och kreativa yrkesverksamma.

För enklare dokumentationsändamål kan du överväga Pixlr E. Detta är ett webbaserat verktyg för produktdokumentation med mycket av Photoshop's funktionalitet, men utan att behöva installeras på en enhet.

Du kan lägga till text, lasso och kopiera pixlar, sudda ut, fylla med färg (med hjälp av hexvärden eller RGB-färghjul), beskära, pensla, pennan, flytande, automatisk läkning, lägga till eller ta bort lager och mycket mer! Redigerade bilder sparas i molnet redo att nås eller delas; allt du behöver är en modern webbläsare.

Ge Pixlr E ett försök när du tar skärmdumpar! Efteråt kan du kopiera och klistra in exporterade bilder direkt i Docsie!

11. JotForm

Docsie har redan ett feedbackformulär för dokumentation - Docsie Vocally. Detta är dock endast avsett för återkoppling från läsare av Docsie-böcker och inte för allmän återkoppling.

Med hjälp av verktyg för produktdokumentation som JotForm kan du skapa dynamiska webbformulär och bädda in dem direkt i Docsie Books. Ett exempel är för kunskapsbaser, där du under varje artikel kan inkludera ett formulär för IT-tjänsteärenden.

Integrationen med ZenDesk innebär att formulärsvar automatiskt kan laddas in i programvaran för IT-servicedeskbiljetter!

Prova att lägga till JotForms i dina Docsie-böcker! Feedbackformulär är ovärderliga i strävan efter dokumentationen; du kan inte fixa det du inte vet!

Prova de här verktygen i Docsie idag!

Alla de verktyg för produktdokumentation som anges ovan är kompatibla med Docsie! Vi rekommenderar starkt att du provar dessa verktyg i Docsie för att maximera din effektivitet och produktivitet!

Börja skapa dokumentation som hjälper dina kunder att göra mer. Registrera dig för vår Startup-plan (forever free!) och leverera dokumentationsglädje med Docsie!


Subscribe to the newsletter

Stay up to date with our latest news and products