Introduktion till docs.microsoft.com

Det här inlägget har skrivits av Jeff Sandquist, General Manager inom Cloud + Enterprise-avdelningen.

Idag presenterar vi förhandsversionen av vår nya dokumentationstjänst https://docs.microsoft.comsom visar innehåll som stöder våra Enterprise Mobility-produkter.

Varför docs.microsoft.com?

Kort sagt, innehåll är viktigt. Vi har intervjuat och genomfört undersökningar bland hundratals utvecklare och IT-proffs och gått igenom er webbplatsfeedback under åren på UserVoice. Det var tydligt att vi behövde genomföra en förändring och skapa ett modernt webbgränssnitt för innehåll. Det första vi gjorde var att utvärdera vår befintliga innehållsinfrastruktur TechNet och MSDN. Båda webbplatserna bygger på en 10–15 år gammal sårbar kodbas med ett omodernt publicerings- och distributionssystem som aldrig utformades för att köras i molnet.

Vår fokus låg inte bara på gränssnittet, utan även på innehållet vi skapar och hur du använder det. I flera år har kunder bett oss att gå längre än textmängder med innehåll på funktionsnivå och hjälpa dem att implementera lösningar på deras affärsproblem. Vi visste att innehållet vi levererade och plattformen vi byggde måste göra det enkelt för kunderna att lära sig och distribuera lösningar.

Vi insåg att det var bäst att börja om från början och skapa en ny, enhetlig användarupplevelse. Resultatet blev https://docs.microsoft.com – Microsofts uppdaterade dokumentationsmiljö.

Obs! Den här förhandsversionen av webbplatsen innehåller innehåll *endast* för Enterprise Mobility Documentation (som består av Advanced Threat Analytics, Azure Active Directory, Azure Remote App, Multi-Factor Authentication, Azure Rights Management, Intune och Microsoft Identity Manager). I framtiden, i och med att vår plattform utvecklas med hjälp av feedback, kommer vi att migrera mer av vår dokumentation till det här gränssnittet.

Viktiga funktioner

Vi börjar med en exempeldokumentationssida som visas nedan och visar några av de nya funktionerna på webbplatsen.

Läsbarhet

För att förbättra innehållets läsbarhet har vi ändrat till fast innehållsbredd på webbplatsen. Ögonspårningsstudier har visat att du kan förbättra förståelsen och läshastigheten med en fast innehållsbredd eftersom det är svårt för ögat att följa långa passager från vänster till höger. För att åskådliggöra det visas nedan ett exempel på en Intune-artikel på docs.microsoft.com följt av samma artikel på TechNet. Vi har också ökat teckenstorleken för det vänstra navigeringsfältet och själva texten, något som kunderna har efterfrågat (UserVoice – Öka teckenstorleken).

Beräknad lästid

En annan enkel förbättring som vi har gjort baserat på dina indata är att ge en uppskattad lästid för en artikel. Vi vet att många av er lär sig/utvärderar teknik några minuter mellan mötena och det är mer troligt att du läser artiklar om du visste hur mycket tid som krävs. Vi har även lagt till datumstämplar i innehåll så att kunderna ser hur ny informationen är utifrån UserVoice-feedback.

Innehåll och webbplatsnavigering

Ett viktigt investeringsområde baserat på kundintervjuer och UserVoice-feedback var förbättringar i webbplatsnavigering, informationsarkitektur och innehållsorganisation baserat på kundens avsikt. Vi omstrukturerade innehållet i logiska grupper kring utvärdera, komma igång, planera, distribuera, hantera och felsöka produkter och tjänster. Innehållet är uppdelat både i navigeringen till vänster och på våra produkt-/tjänstsidor.

Nedan visas en skärmbild av startsidan för Intune-dokumentation:

Samma kategorisering finns även i navigeringen till vänster i artiklar:

Kortare artiklar

En annan vanlig feedback var att vårt innehåll ibland kan vara överväldigande på grund av dess längd och att långa artiklar är svårare att navigera och hitta det du letar efter. För att åtgärda detta har vi delat upp många längre artiklar i mindre logiska steg och angett knapparna Föregående och Nästa längst ned i artiklarna för att navigera mellan stegen i en självstudie i flera delar enligt nedan.

Även om många kunder vill ha möjligheten till självstudier i flera delar, har vi också hört från kunder som vill kunna sätta ihop självstudier med flera steg till en enda PDF-fil som kan användas offline och som kan skrivas ut. Vi har inte det ännu, men det kommer snart att finnas i förhandsversionen.

Responsiv design

För att skapa ett bra gränssnitt på mobila enheter, surfplattor och datorer som har efterfrågats på UserVoice har vi bytt till en responsiv layout. Om du klickar på Alternativ visas/döljs samma alternativ i en skrivbordsvy.

Bidrag från communityn

All dokumentation på docs.microsoft.com bygger på öppen källkod och är utformad för att tillåta communitybidrag. Det följer andra team på Microsoft som redan har använt öppen källkod för all eller viss dokumentation, inklusive ASP.NET, Azure, .NET Core och Microsoft Graph.

I alla artiklar finns en redigeringsknapp (visas nedan) som leder till markdown-källfilen i GitHub. Där kan du enkelt skicka en pullbegäran om att rätta eller förbättra innehållet.

Feedbackmekanismer

Dina frågor, kommentarer och feedback är viktig för oss. Vi har samarbetat med [Livefyre](https://web.livefyre.com/) för att ge kommentarer och sidokommentarer för alla våra artiklar. Längst upp i varje artikel visas en länk för kommentarer enligt nedan.

Om du klickar på kommentarer hamnar du längst ned på sidan där du kan logga in (med autentiseringsuppgifter för Twitter, Facebook, Google, Yahoo eller Microsoft) och lägga till, följa eller gilla kommentarer.

Du kan också lägga till sidoanteckningar eller anteckningar i varje stycke med innehåll eller specifikt markerad text. Klicka med pekaren på kommentarssymbolen till höger om du vill lägga till en infogad kommentar.

Social delning

Med delningsknappen längst upp på sidan kan du enkelt dela med Twitter och Facebook.

Du kan också markera innehåll i en artikel med pekaren och lägga till en kommentar eller dela på Twitter eller Facebook direkt från snabbmenyn enligt nedan.

Tydliga webbadresser

Webbgränssnittet är viktigt och en sak som regelbundet har stört oss som användare av TechNet och MSDN är att artiklarna inte hade tydliga, läsbara webbadresser. Här är ett exempel på samma artikel med våra nya URL:er.

• Innan:<https://technet.microsoft.com/library/dn646983.aspx>

• Efter:<https://docs.microsoft.com/intune/get-started/start-with-a-paid-subscription-to-microsoft-intune>

Webbplatsteman

Vi har även lagt till en temaväljare i artiklar så att du kan ändra mellan ljust och mörkt tema, något som vissa har efterfrågat på UserVoice.

På bilden nedan visas skillnaden mellan ljust och mörkt tema.

Grunder

Grunder som webbplatsprestanda är en viktig del och något som många kunder har bett oss att förbättra på UserVoice. Sidinläsningstiden på docs.microsoft.com är 50–300 % snabbare och vi är bättre fördelade geografiskt än någonsin tidigare. Vi har också byggt på en arkitektur som körs 100 % på Azure.

Vi vill gärna höra dina synpunkter!

Vi hoppas att du gillar förhandsversionen av docs.microsoft.com. Skicka gärna feedback till https://aka.ms/sitefeedback. I framtida inlägg kommer vi att diskutera våra planer för att dramatiskt förbättra upplevelsen av referensinnehåll och våra planer för innehållslokalisering.