Nyheter kring migreringen från MSDN och TechNet till docs.microsoft.com

  • Artikel

Det här inlägget skrevs av Jeff Sandquist, Corporate Vice President, utvecklarrelationer.

Idag har vi en viktig nyhet om migreringen av innehållet på MSDN och TechNet till docs.microsoft.com. I det här blogginlägget går vi igenom de avslutande stegen i ett projekt som hela företaget varit inblandat i, om att ändra hela innehållsstrukturen, formatet och den underliggande infrastrukturen för att centralisera Microsofts tekniska dokumentation på en enda webbplats.

Från MSDN och TechNet till docs.microsoft.com

Microsoft Developer Network såg dagens ljus redan 1992. Det var då en prenumerationstjänst där kunderna fick teknisk information om programmering för Windows. Sex år senare, 1998, lanserades webbplatsen MSDN Online med fler än 250 000 sidor med innehåll.

Skärmbild av MSDN Online 1999

På den tiden bestod publiceringsprocessen av att skapa innehåll i Microsoft Word, konvertera det till HTML och publicera det via ett verktyg som hette pubwiz (Publishing Wizard). I mer än 20 år användes den här processen till lansering av nya produkter, tjänster och uppdateringar. Vi genererade faktiskt hela 45 000 000 sidor med tekniskt innehåll!

När produktlanseringscykeln krympte från år till månader växte samtidigt efterfrågan på tillgänglig och uppdaterad dokumentation. Publiceringssystemet behövde vara lika smidigt som utvecklingen, så vi beslutade oss för att tänka nytt kring hanteringen av dokumentation på Microsoft i dagens molnera. I november 2015 skrev grundarna till teamet bakom docs.microsoft.com – Dan Fernandez, Mary McHale, Carol Zeumault, och Jeff Sandquist ett dokument med titeln ”A New Hope” (en blinkning till Stjärnornas Krig) där de beskrev visionen för den nya webbplatsen. De tog upp några viktiga riktlinjer:

  • Enhetlig teknisk dokumentation. Microsoft skulle samla alla sina dokumentationssidor på den nya webbplatsen. En utvecklare som försöker lära sig att skapa en datadriven webbapp skulle bara behöva besöka en enda webbplats för att hitta allt relevant innehåll om ASP.NET, Azure, Entity Framework och andra Microsoft-tekniker.
  • En bättre upplevelse för användarna. Kundernas upplevelse är ett bra sätt att mäta hur framgångsrik en webbplats är. Den nya webbplatsen bör ha en bättre inläsningsprestanda, läsbara teckensnitt, lättillgängliga innehållsförteckningar, webbadresser som är lätta att läsa, stöd för versionshantering, kompatibilitet med mobila webbläsare och ha en inkluderande design med bland annat tillgänglighetsfunktioner och stöd för internationalisering.
  • Demokratisera innehållsskapandet och communityns engagemang. Den nya webbplatsen bör använda standarder och verktyg med öppen källkod så att alla kan skapa och redigera dokumentationen. Markdown bör användas för innehåll, YAML för automatiskt genererad API-dokumentation och GitHub bör användas som underliggande innehållslager så att kvalitetskontrollen kan automatiseras. GitHub-organisationen MicrosoftDocs har nu fler än 7 400 medlemmar. Repon med Azure-dokumentation är ett av de snabbast växande projekten med öppen källkod (470 % på årsbasis) och den ligger på plats 5 sett till antal bidrag på hela GitHub enligt The State of the Octoverse 2018!
  • Stöd för API-dokumentation. Den nya webbplatsen bör ha förstklassigt stöd för dokumentation av API:er som skrivits för programmeringsspråk och plattformar som våra kunder använder, inklusive .NET, Java, Python, JavaScript och TypeScript, PowerShell, Azure CLI, Q#, OpenAPI med mera. Miljön bör vara automatiserad, API-täckningen ska vara tillförlitlig och det ska gå att publicera API-dokumentation på några minuter snarare än att det tar flera veckor.
  • En modernare teknisk infrastruktur. docs.microsoft.com bör köras i Azure så att vi kan minska underhållskostnaderna (besparingar på mer än 7 miljoner USD), korta ned distributionstiden från var tredje vecka till varje dag (eller snabbare) och minska den tekniska redundansen.
  • Inbyggda utvecklingsmöjligheter. I takt med att webbplatsen utvecklas måste den fortsätta att uppfylla kundernas behov så effektivt som möjligt. Det här åtagandet gjorde att vi kunde skapa och integrera en helt ny och interaktiv utbildningsmiljö, Microsoft Learn, och vår utforskare för kodexempel.

Nu när den moderna plattformen finns på plats jobbar vi hårt med att migrera äldre värdefullt innehåll till den nya webbplatsen så att det inte går förlorat. Här kan du läsa lite mer om hur det går för oss.

MSDN- och TechNet-bibliotek

Status: ✅ Slutförd

Vi påbörjade migreringen av MSDN- och TechNet-bibliotek till docs.microsoft.com i slutet av 2017, och migreringen slutfördes i år.

Biblioteken innehöll tidigare dokumentation om Microsoft-produkter, till exempel API-dokumentation, kodexempel och tekniska artiklar. Innehållet var ursprungligen tillgängligt på CD-skivor, men det flyttades online när vi lanserade webbplatserna MSDN och TechNet.

Under migreringen behövde vi konvertera en mängd olika XML-baserade format till Markdown för innehåll som redigeras av människor och till YAML för automatiskt genererad API-dokumentation, och det här gällde fler än 100 olika innehållsuppsättningar. Vi har ordnat med omdirigeringar för miljontals webbsidor, så att inte gamla länkar på bloggar och forum utanför vår webbplats ska leda fel.

Här är lite statistik som kan ge dig en uppfattning om hur mycket innehåll vi har arbetat med:

Om du har bokmärken till innehåll på MSDN eller TechNet så kommer de att leda till den nya sökvägen på docs.microsoft.com.

MSDN Magazine

Status: ✅ Slutförd

Det sista numret av MSDN Magazine publicerades den 1 november 2019. Vi skickade ett avslutande meddelande till våra läsare och skribenter i augustinumret av MSDN Magazine.

Innehållet i MSDN Magazine som publicerats på MSDN har flyttats till docs.microsoft.com/archive.

MSDN Magazine-prenumeranter som betalat för sin prenumeration kommer att få tillbaka pengar för den tid som återstår av prenumerationen. Checkarna med återbetalningen skickas ut efter att novembernumret har publicerats. Den här ändringen påverkar inte prenumerationen på MSDN-plattformen.

Nyhetsbreven Microsoft Developer och TechNet Flash

Status: ✅ Slutförd

Nyhetsbreven som publicerades på MSDN och TechNet har flyttats till docs.microsoft.com/archive.

Prenumeranterna kommer att fortsätta få de här nyhetsbreven. Vi kan komma att utveckla och ändra både formatet och publiceringsschemat.

Om du inte längre vill prenumerera på våra nyhetsbrev kan du avbryta prenumerationen i nästa e-postmeddelande du tar emot.

Bloggar på MSDN och TechNet

Status: ✅ Slutförd

Vi gjorde webbplatserna med MSDN- och TechNet-bloggar skrivskyddade i juli 2019. MSDN- och TechNet-bloggar har migrerats och arkiverats till docs.microsoft.com/archive.

Om du har bokmärkt några MSDN- eller TechNet-bloggar omdirigeras länkarna till dem antingen till den nya platsen på docs.microsoft.com/archive eller till andra bloggwebbplatser om de aktivt underhålls och uppdateras bloggar.

Status: ✅ Slutförd

Vi har dirigerat om alla sidor i MSDN-kodgalleriet till exempelutforskaren och arkiverat viktiga exempel på GitHub i organisationen MicrosoftArchive. Du kan läsa mer om den här processen i vårt senaste blogginlägg.

De mest aktuella kodexemplen finns på docs.microsoft.com/samples.

Status: 🚧 Pågår

TechNet-galleriet tas ur bruk i början av 2020. Webbplatsen blir skrivskyddad i december 2019 och communityn kan då inte längre lämna bidrag. Det kommer fler meddelanden och mer information om det här snart.

På docs.microsoft.com/samples hittar du de mest aktuella kodexemplen. Om du har gjort bidrag till TechNet-galleriet tidigare ska du migrera dina exempel till en plats du hanterar själv, till exempel din egen lagringsplats på GitHub.

TechNet Wiki

Status: 🚧 Pågår

Vi jobbar på att ta fram en mer konkret migreringsplan och ett schema för TechNet Wiki. Mer information kommer inom kort. Du kan fortsätta att använda och interagera med innehållet på wikin så länge.

Forum på MSDN och TechNet

Status: 🚧 Pågår

Vi har presenterat en förhandsversion av Microsoft Q&A, som ersätter forumen på MSDN och TechNet. Vi har delat upp migreringen i flera faser så att övergång ska bli så smidig som möjligt. Målet är att slutföra migreringen i mitten på 2020. Mer information kommer inom kort.

Kanal 9

Status: 🚧 Pågår

Channel 9 fortsätter att vara en viktig investering när det gäller videoinnehåll för utvecklare. Vi jobbar med att ta fram en migreringsväg där vi kan integrera videor och tekniskt innehåll från Channel 9. Mer information kommer inom kort.

Vi vill veta vad du tycker

Vi är glada att kunna fortsätta investera i vår plattform och ge dig den mest relevanta och tillförlitliga tekniska dokumentationen om Microsofts hela ekosystem. Berätta gärna vad du tycker och kom med förslag på förbättringar på GitHub och Twitter.