Skapa GitHub-problem för produkter med öppen källkod
I den här artikeln lär du dig hur du skapar ett GitHub-problem för Microsoft Learn-dokumentation som rör produkter med öppen källkod. Den lär dig också hur du läser andra användares problem och antingen lägger till egna kommentarer till dem eller öppnar en pull-begäran (PR) för att åtgärda dem.
Vår produktdokumentation med öppen källkod är ett kontinuerligt pågående arbete. Att ta emot bra GitHub-problem från deltagare hjälper oss att fokusera vårt arbete på de högsta prioriteringarna för communityn.
Om du vet hur du åtgärdar ett problem uppmanar vi dig naturligtvis att göra ändringarna själv, i stället för att öppna ett problem.
Kommentar
Endast produkter med öppen källkod som använder feedback med öppen källkod accepterar GitHub-problem. Mer information och en lista över deltagande lagringsplatser finns i Använda upplevelsen med öppen källkod. Mer information om hur du ger feedback som inte kommer från GitHub på Microsoft Learn-plattformen finns i Ge feedback om Microsoft Learn.
Förutsättningar
- Skapa ett GitHub-konto om du inte har något.
Skapa en uppgift
Gå till den artikel som du vill kommentera.
Bläddra längst ned i artikeln, där du ser alternativ för att skicka feedback. Välj Öppna ett dokumentationsproblem för att skapa ett nytt problem. Den här feedbacken är specifik för innehållet och spåras som ett problem i GitHub.
Du kan också välja Ge produktfeedback för att gå till ett mål (till exempel en feedbackportal, GitHub, en e-postadress) där du kan ge feedback om själva produkten. Den här feedbacken är oberoende av innehållet och har ingen relation tillbaka till den ursprungliga artikeln.
Systemet öppnar ett nytt problem för dig på GitHub-lagringsplatsen som lagrar innehållet för den artikel som du visar. Lägg till en rubrik och en beskrivning. alla andra fält bör fyllas i automatiskt. När du är klar väljer du Skicka nytt problem.
Ju mer information du anger, desto mer användbart är problemet. Berätta vilken information du sökte eller vilka söktermer du använde för att komma till den här artikeln. Om du inte kan komma igång, berätta för oss hur du vill börja utforska okänd teknik. Du kan också lägga till skärmbilder eller filer som hjälper oss att förstå ditt problem.
Det var allt! Ditt problem har nu lagts till i ärendekön. Ärenden påbörjar konversationen om vad som behövs. Innehållsteamet svarar på dessa problem med idéer om vad vi kan lägga till och be om dina åsikter.
Kommentera ett problem
Du kan kommentera eventuella problem på en lagringsplats som stöder GitHub-problem. Du kan också lägga till egna kommentarer i ett problem som du har skapat.
Leta reda på problemet som du vill kommentera. I webbläsaren navigerar du till den GitHub-lagringsplats som du vill titta på problem för. Välj fliken Problem för att se de öppna problemen för lagringsplatsen. Om lagringsplatsen har många problem använder du filterfältet för att filtrera efter etikett, författare med mera. Eller använd sökfältet för att söka efter specifika frågor. När du har hittat ett problem som tilltalar dig väljer du det för att öppna det.
Endast produkter med öppen källkod som använder feedback med öppen källkod accepterar GitHub-problem. Mer information och en lista över deltagande lagringsplatser finns i Använda upplevelsen med öppen källkod.
Läs problemet och eventuella kommentarer som redan har lagts till av andra. Om du vill lägga till en kommentar bläddrar du längst ned i problemet och anger din kommentar i rutan Lämna en kommentar . När du är klar väljer du Kommentar.
Öppna en pull-begäran för att åtgärda problem
När du bläddrar bland problem kan du hitta en som du vet hur du åtgärdar. I så fall är du välkommen att öppna en PR för att åtgärda problemet. Mer information finns i Redigera dokumentation i webbläsaren.
När du har öppnat en PR för att åtgärda problemet återgår du till problemet och lägger till en kommentar som länkar till din PR. Detta hjälper oss att spåra problemet och PR tillsammans. Använd pundtecknet (#) följt av PR-numret för att länka till PR. Om ditt PR-nummer till exempel är 4210 anger #4210 du i kommentaren.
