1. Nettdesign og utvikling Hvordan skrive en god GitHub Pull-forespørsel

Av Sarah Guthals

Å skrive en flott pull-forespørsel i Git for GitHub-kontoen din er litt kunst. For et prosjekt med åpen kildekode, skjer mye av prosjektets kommunikasjon med mennesker innenfor trekkforespørsler.

Hvis du bidrar til et prosjekt, er trekkforespørselen din sjansen til å lage en sterk sak for hvorfor koden din skal trekkes inn i hovedgrenen. Sørg for å sette din beste fot frem.

Kjenn publikum for din Git pull-forespørsel

Før du skriver et enkelt ord, er det nyttig å forstå publikum, slik at du kan fokusere ordene dine på det som er mest nyttig. En trekkforespørsel kan tjene mange målgrupper. Å ha alle målgruppene dine i tankene er viktig, men det primære fokuset er på folk som vil gå gjennom og ta en beslutning om hvorvidt trekkforespørselen din vil bli slått sammen. Du vil gjøre livet enklere, ettersom de pleier å være veldig opptatt.

Selv om prosjektlederne er ditt primære publikum, bør du aldri glemme at mange andre vil lese trekkforespørselen. For et prosjekt med åpen kildekode kan dette publikum være hele verden. Så hold språket ditt respekt, vennlig og inkluderende.

Det er ganske vanlig å få noen til å skrive en trekkforespørsel i form av sinne og senere angre på ordene de bruker. Så hvis du tilfeldigvis er raseri-koding, kan du ta et øyeblikk til å kjøle deg ned og samle tankene dine før du oppretter trekkforespørselen.

Gjør formålet med GitHub-trekkforespørselen klar

Sørg for å være kortfattet og informativ. For eksempel bør sammendraget gjøre formålet med trekkforespørselen klar. Sammendraget er den eneste delen som vises på siden som viser trekkforespørsler. Det må kunne skannes.

Her er noen eksempler på gode trekkoppsummeringer:

  • Legger til Om-siden på nettstedet Minimer konfigurasjonskoden for kjeleplaten for JavaScript-biblioteker Pakk ut og isoler feilhåndtering fra GitStore internals

Her er noen dårlige eksempler hentet fra mine egne depoter.

  • Lag er for alltid Skrivefeil Små endringer

Beskrivelsen skal gi litt mer forklaring om formålet med trekkforespørselen. Ikke skriv en bok, men gjør det klart hva trekkforespørselen prøver å oppnå.

Hold fokus på GitHub-trekk

Akkurat som en forpliktelse, bør en trekkforespørsel ikke inneholde en mengde ubeslektede endringer. En trekkforespørsel kan bestå av flere forpliktelser, men de bør alle være relatert til oppgaven.

Du kan ofte fortelle at en pull-forespørsel gjør for mye når du skriver en kortfattet beskrivelse av hva pull-forespørselen oppnår er vanskelig.

Selv om trekkforespørselen er fokusert på en eneste større endring, hold trekkforespørselen til en håndterbar størrelse. Det er vanskelig å gjennomgå en veldig stor trekkforespørsel.

Hvis trekkforespørselen adresserer en veldig stor oppgave, del opp oppgaven i mindre trinn og send inn trekkforespørsler for hvert trinn.

Forklar hvorfor bak GitHub-forespørselen din

Det forrige forslaget fokuserer på hva pull-forespørselen gjør. Du må også forklare hvorfor du tar på deg dette arbeidet. Beskrivelsen om trekkforespørsel er en mulighet til å gi lenker til andre dokumenter som gir mer kontekst. Du kan ikke anta at alle er kjent med historien.

Hvis du har mye kontekst å dele, kan du gi et kort sammendrag etterfulgt av flere detaljer i en -kode. Hvis du for eksempel legger til en kommentar om trekkforespørsel med følgende tekst:

Grunnen til at vi legger ut på dette arbeidet, skyldes overholdelsesgrunner.

## Mer informasjon

Jeg ønsker ikke å kjede alle med alle de pusete detaljene, men for de som er interessert, fortsett å lese ...

GitHub viser detaljdelen som er kollapset som standard, som vist.

Detaljer om forespørsel fra GitHub

Klikk på detaljetiketten for å utvide detaljdelen, som vist her.

Detaljer om forespørsel fra GitHub

Slik legger du til et bilde i GitHub-forespørselen din

GitHub støtter å legge til bilder i en beskrivelse av trekkforespørsler ved å dra og slippe et bilde. Når du drar og slipper bildet i tekstfeltet, laster GitHub opp bildet og erstatter det med markeringen for å gjengi et bilde. Følgende figur viser en opplasting pågår etter at et bilde er dratt inn i et kommentarfelt for trekkforespørsel.

GitHub trekke forespørselsbilde

Denne kommentaren er veldig meta da den er et skjermbilde av samme depot som det er en kommentar til.

Hvis et bilde er verdt tusen ord, er et animert gif verdt enda mer. Hvis du kan lage et animert gif som demonstrerer atferdsendringen som ble introdusert av pull-forespørselen, legger du til at gif i pull-forespørselen vanligvis er veldig verdsatt av de som vurderer den.

Inkluder en oppfordring til handling i GitHub-forespørselen din

Du må være veldig tydelig på hvilke tilbakemeldinger du ønsker fra andre på trekkforespørselen. Hvis for eksempel pull-forespørselen er et arbeid som pågår, må du gjøre det klart fra starten, slik at folk ikke kaster bort tid på å gjennomgå en pull-forespørsel som ikke er klar til gjennomgang.

Følg konvensjonene i depotet for å gjøre det klart. Du kan finne ut konvensjonene ved å orientere deg om depotet.

Å følge stevnene er viktig, slik at andre vet hva som forventes av dem med hensyn til din trekkforespørsel.

  1. Nettdesign og utvikling Tiltak med GitHub-handlinger

Av Sarah Guthals

GitHub har en funksjon som fjerner behovet for å være vertskap for appen vår utenfor GitHub, noe som kan redusere antall bevegelige deler når du utvider GitHub. Denne funksjonen kalles GitHub-handlinger.

GitHub Actions er en av de nyere, mest spennende funksjonene i GitHub. I skrivende stund er det fortsatt en betafunksjon. GitHub-handlinger gjør det mulig å lage tilpassede arbeidsflyter på GitHub. Den lar deg implementere tilpasset logikk for å svare på hendelser på GitHub. I forrige seksjon skrev vi en GitHub-app for å gjøre det. Med GitHub-handlinger trenger vi ikke å lage en tilpasset app. Vi kan bygge arbeidsflyter ved å bruke eksisterende handlinger som andre har skrevet, eller vi kan skrive våre egne handlinger som kjører i en Docker-beholder.

Forhåpentligvis, når du leser dette, er GitHub-handlinger generelt tilgjengelige. Men i tilfelle de fremdeles er i beta, kan du sende en e-post til support@github.com og be om å være i GitHub Actions-betaprogrammet.

For å demonstrere GitHub-handlinger, vurder følgende scenario. Når du fusjonerer en trekkforespørsel i ditt eget depot, stikker grenen for trekkforespørselen rundt. GitHub presenterer en knapp for å slette grenen, men mange glemmer å gjøre det og lar disse grenene holde seg rundt.

Å ikke slette grenen er ikke nødvendigvis en dårlig ting, med mindre du er den typen personer som liker at ting er ryddig og ikke kan tåle å ha en gren som ikke lenger trenger å henge med. Hvis du er den typen personer, har du flaks. Jesse Frazelle er også den typen personer, og hun skrev en GitHub-handling du kan bruke i dine egne arbeidsflyter. Blogginnlegget hennes, “The Life of a GitHub Action” er en god lese for å forstå flere detaljer om livssyklusen til en GitHub-handling.

Opprette en arbeidsflyt fra GitHub-handlingen

Hvis du er blitt akseptert i beta-programmet GitHub Actions, eller det har blitt mer tilgjengelig, bør du se en ekstra fane øverst merket Handlinger når du ser et depot.

Følgende trinn går gjennom prosessen for å lage en arbeidsflyt fra GitHub for et depot.

GitHub-arbeidsflyterGitHub enkle arbeidsflyter

Testing av en GitHub-handling

Etter at du har forpliktet denne filen til depotet ditt, er arbeidsflyten aktiv. Du kan teste den ved å opprette en ny trekkeforespørsel og deretter slå den sammen. Noen sekunder eller minutter senere skal du se at grenen for trekkforespørsel ble slettet. En oppdatering på pull-forespørselen sier noe som

github-actions bot slettet grenenavnet for 1 minutt siden

Du kan lage ganske nyttige og komplekse arbeidsflyter ved å bruke eksisterende handlinger. Du kan installere handlinger fra GitHub Marketplace eller referere dem ved å peke til et depot som inneholder en handling. Du kan også skrive tilpassede handlinger. Hvordan du gjør det er utenfor rammen for denne artikkelen, men du kan se på handlingen som Jesse skrev for å få et inntrykk av hva som trengs.

Med GitHub-handlinger kan du tilpasse GitHub til din smak på nesten ubegrensede måter.

  1. Nettdesign og utviklingGitHub-apper og probot

Av Sarah Guthals

Apper på GitHub lar deg utvide GitHub på kraftige måter. GitHub-apper er nettapplikasjoner som kan svare på hendelser på GitHub. Disse arrangementabonnementene kalles nettkroker. Når en hendelse oppstår på GitHub som appen er interessert i, sender GitHub en HTTP-forespørsel til appen med informasjon om hendelsen. Appen kan deretter svare på den hendelsen på noen måte, ofte som resulterer i en tilbakeringing til GitHub via GitHub API.

Her går du gjennom å bygge en enkel GitHub-app som bringer litt avgift til diskusjonene dine. Det er en gammel meme i form av en animert gif med en liten jente som stiller spørsmålet, "Hvorfor har vi ikke begge deler?" Den typiske bruken av dette meme er svar på et spørsmål som presenterer en falsk dikotomi. Med andre ord, når noen presenterer et spørsmål med to valg, kan noen svare med dette bildet.

Vi presenterer GitHub's Probot

GitHub-apper er nettapplikasjoner som må lytte til HTTP-forespørsler. Du har mange viktige detaljer for å komme akkurat når du bygger en HTTP-forespørsel, for eksempel hva er formatet på dataene som er lagt ut til appen? Alle disse detaljene kan være forvirrende og tidkrevende å bli riktig når du bygger en GitHub-app fra bunnen av. Det er vanskelig å vite hvor du skal begynne.

Probit-rammeverket til GitHub kommer godt med når du kommer i gang med en GitHub-app. Probot håndterer mye av kjelplaten og nitpicky detaljer om å bygge en GitHub-app. Det er et rammeverk for å bygge GitHub-apper ved å bruke Node.js. Det gir mange bekvemmelighetsmetoder for å lytte til GitHub-hendelser og for å ringe til GitHub API.

Probot gjør det enkelt å bygge en GitHub-app, men det løser ikke problemet med hvor du skal være vert for appen.

Vert for GitHub-appen

En GitHub-app kan ta mange former. Det kan være en Node.js-app som kjører i Heroku, en ASP.NET Core-app som kjører i Azure, en Django-app som kjører i Google Cloud - det spiller ingen rolle. Det trenger bare å være vedvarende og tilgjengelig via det offentlige Internett, slik at GitHub kan nå det med nyttelast fra hendelser.

Å sette opp alt dette kan være tidkrevende, så for våre formål bruker vi Glitch til å implementere en rask og skitten GitHub-app.

Vi introduserer Glitch

Glitch er en vertsplattform for webapplikasjoner som fjerner mye av friksjonen med å få en web-app i gang. Alle apper du oppretter i Glitch, er live på nettet fra begynnelsen. Du trenger ikke å tenke på hvordan du planlegger å distribuere koden fordi enhver endring du gjør blir lagret automatisk og distribuert automatisk.

Glitch fokuserer på samfunnsaspektet ved å bygge apper. Hver fil kan redigeres av flere personer i sanntid, på samme måte som du kan redigere et dokument i Google Dokumenter. Og hvert prosjekt kan remixes ved å klikke på en knapp. Dette oppmuntrer til mye deling av kode og læring av hverandre, noe som kommer godt med når vi bygger vår egen GitHub-app.

Før du fortsetter, sørg for å opprette en konto på Glitch hvis du ikke allerede har en.

Lag en Probot Glitch-app

Etter at du har en grov forståelse av Probot og har satt opp en Glitch-konto, kan du bygge en Probot-app på Glitch. Med Glitch kan du remikse eksisterende apper, og den gode nyheten er at Glitch allerede har en Probot-app som du kan remikse. Dette betyr at du kan opprette Probot-appen din med ett klikk og noen få tilpasninger.

For å opprette appen din skriver du inn følgende URL i nettleseren din: https://glitch.com/edit/#!/remix/probot-hello-world.

Denne kommandoen lager en helt ny app i Glitch basert på probot-hallo-verden-eksemplet med en tilfeldig generert URL, som vist. Som du kan se, appen min heter candy-chaffeur.

GitHub Glitch Probot-app

Den venstre ruten viser listen over filer i applikasjonen din. README.md-filen inneholder trinn-for-trinn-instruksjoner for å sette opp hei-verden Probot-appen. Følg disse instruksjonene nøye for å sette opp prøven GitHub-appen.

En av instruksjonene nevner å kjøre følgende kommando:

cat my-app-name.2018-06-20.private-key.pem | pbcopy

Hensikten med den forrige kommandoen er å kopiere innholdet i din private nøkkelfil til utklippstavlen, slik at du kan lime den inn i Glitch-filen. Denne kommandoen fungerer imidlertid bare på en Mac. På Windows vil du kjøre følgende kommando (endre filnavnet slik at det samsvarer med ditt):

skriv inn min-app-navn.2018-06-20.private-key.pem | klemme

Når du er ferdig, installerer du appen i et depot du eier, og oppretter deretter en ny utgave. Noen sekunder senere skal du se en kommentar opprettet av boten din med ordene "Hello World!".

Tilpass appen

Etter at du har opprettet en Probot-app i Glitch og installert den på GitHub, kan du tilpasse hvordan appen reagerer på å gi kommentarer. Når du fulgte trinnene i README, abonnerte du på utgivelsesarrangementer. Disse hendelsene inkluderer ikke når nye kommentarer opprettes. Vi må også abonnere på kommentarer.

Se en liste over appene dine her. Klikk på Rediger-knappen for å navigere til appen din. I venstre navigasjon klikker du deretter på Tillatelser og hendelser og blar ned til delen Abonner på hendelser. Merk av for Utgavekommentar, som vist.

GitHub-abonnement

Klikk Lagre endringer-knappen nederst for å fullføre disse endringene.

Nå må du endre Glitch-appen din for å lytte til kommentarer til nye utgaver og svare riktig. Rediger filen index.js og erstatt innholdet i filen med følgende kode:

module.exports = (app) => {

// Lytter til kommentarer om nye utgaver

app.on ('issue_comment.created', async context => {

// Henter frem kommentarteksten

const melding = context.payload.comment.body

if (melding.indexOf ('eller')> -1) {

const params = context.issue ({

body: '! [Hvorfor ikke jenta begge to] (https://media3.giphy.com/media/3o85xIO33l7RlmLR4I/giphy.gif)'

})

// Oppretter en kommentar med et nedslagsbilde

return context.github.issues.createComment (params)

}

})

}

Denne koden lytter til nye utgivelseskommentarer, ser etter ordet eller er omgitt av mellomrom, og hvis den finner det, oppretter du en ny kommentar med et nedslagsbilde.

Denne tilnærmingen er ikke veldig smart. Prøv denne litt bedre tilnærmingen. Det ville vært enda bedre om vi kunne ansette noen kunstig intelligens (AI) i form av naturlig språkbehandling (NLP). Men det er utenfor kompetansesettet mitt og utenfor rammen for denne boken.

Installere appen

Etter at du har opprettet appen og fått den til å fungere, kan andre installere appen og bruke den. Du kan installere den ved å gå til GitHub-applisten din og klikke på den store grønne Installer-knappen øverst til høyre.

Installer det på et repository og deretter lage en kommentar til et problem i depotet som stiller et spørsmål med ordet eller i det. Et eksempel på et samspill vises her.

GitHub Why Not app
  1. Nettdesign og utviklingHackathons og andre nettverksarrangementer for GitHub programvareutviklere

Av Sarah Guthals

GitHub er vertskap for og sponser flere konferanser gjennom året. Mange slags arrangementer fokuserer på programvareutviklere. De spenner fra den uformelle møte- eller brukergruppen til den strukturerte internasjonale programvarekonferansen på flere dager.

Se hvilke GitHub-arrangementer som kommer. Denne siden viser GitHubs egne kommende arrangementer, så vel som arrangementer som den sponser.

GitHub hackathon-grafikk

Meet-ups og brukergrupper for programvareutviklere

En møte- eller brukergruppe er en uformell samling av utviklere for å dekke et emne. Mange planlegges månedlig og arrangeres av et lokalt selskap eller interessentgruppe for programvare.

Disse hendelsene har en tendens til å være en flott måte å dyppe tåen på i programvareutviklerhendelser. De pleier å være små sammenkomster av mennesker i ditt område. Hver måned har en lokal foredragsholder som snakker om et tema som er relevant for gruppen. (Noen brukergrupper og møter får med seg høyttalere utenfra ved anledninger, men vanligvis fokuserer de på å fremheve lokale høyttalere.)

Meetups.com er en flott måte å finne et møte som er relevant for dine interesser. Du kan søke etter møter etter sted på meetups.com. Sjekk for eksempel JavaScript-møte for Seattle Washington-området.

Noen få eksempler på lokale møter er

  • Brooklyn JS: Brooklyn, New York .NET São Paulo: São Paulo, Brasil SD Ruby: San Diego, California

Regionale konferanser for programvareutviklere

En regional konferanse er en relativt liten konferanse der foredragsholdere og deltakere utenfor nærområdet er velkomne, men konferansens fokus er å gi et sted for lokale utviklere og foredragsholdere å koble sammen og presentere sitt arbeid.

Ofte er disse konferansene en eller to dager. Mange vil ha et enkelt spor av samtaler, eller to på det meste. De er et steg opp i størrelse og struktur fra et møte og oppstår vanligvis en gang i året, i motsetning til månedlig.

Noen av dem tilbyr ofte workshops enten før eller etter konferansen. Disse verkstedene koster vanligvis ekstra, men tilbyr mer dyptgående trening for et spesifikt skillset eller teknologi. For eksempel kan du ofte finne et heldagsverksted dedikert til å forbedre dine Git-ferdigheter. Hvis du har råd til det og finner en som lærer en ferdighet du ønsker å forbedre, er workshops ofte verdt investeringen.

Noen gode eksempler på lokale konferanser inkluderer

  • .NET Fringe: Portland, Oregon JSConf Hawaii: Honolulu, Hawaii GoRuCo: New York, New York

Hackathons

Et hackathon er veldig forskjellig fra en konferanse. Mens konferanser fokuserer mer på å ha foredragsholdere som underviser i et tema gjennom en tale, fokuserer hackathons på å bygge. Et hackathon er en hendelse som kan vare flere dager der grupper av mennesker danner team for å samarbeide om å skrive kode for å løse et slags problem.

Det vanlige formatet er en slags problemstilling som presenteres og team får i oppgave å bygge en løsning. Teknologibunken de kan bruke er ofte avhengig av fokus for et hackathon. For eksempel vil en mobilutvikling hackathon kreve at deltakerne bygger en mobilapp for å løse problemet.

Hackathon er et portmanteau av ordene hack and marathon. Mange tar maratonaspektet til det ekstreme ved å ha team som jobber døgnet rundt med veldig lite søvn. Andre prøver å skape en balanse mellom arbeidstid og sovetid ved å tvinge deltakerne til å forlate arbeidsområdet.

Hackathons er ofte veldig inkluderende for nybegynnere. For eksempel er SD Hacks åpen for alle videregående skoler eller studenter i verden som er 18 år eller eldre. Du trenger ikke alltid ha et lag når du melder deg på et hackathon. Ofte kan du finne en når du kommer dit. Det er best å sjekke FAQ for den spesifikke hackathon for å lære mer om detaljene.

En av de største hackathonene over hele verden er målrettet mot studenter. Det er Microsoft Imagine Cup. Vinnere av Imagine Cup kan vinne mentorskap fra Satya Nadella (Microsofts administrerende direktør), reise til verdensmesterskapet og motta Azure-tilskudd og $ 100.000.

Å delta på hackathons kan være en fin måte å bli introdusert for en ny teknologi. Målet er ikke å designe og implementere et sluttprodukt, men snarere å hacke sammen biter og brikker for å komme videre med en idé du har. Sluttproduktet skal se mer ut som en prototype enn en polert applikasjon. Ofte vil hackathons ha mentorer som kjenner en bestemt teknologi som du kan lære av. Tenk på et hackathon som et dedikert tidspunkt og sted å eksperimentere og lære.

Selv om å delta på et formelt hackathon vil gi deg mentorer, et rom og noen ganger premier, kan du også alltid komme sammen med venner for å gjøre en på egen hånd, også! Bare velg tid, sted og mål og prøv å hacke sammen en prototype av en idé du har! Det skader ikke å gi det et skudd!

Store konferanser for programvareutviklere

En større konferanse har en tendens til å være stor og trekke deltakere fra hele landet, om ikke verden. Deltakertallene har en tendens til å være i tusenvis. Å delta på en av disse konferansene krever litt mer planlegging på forhånd. Det er ikke bare å ordne fly og hotell. Disse konferansene har en tendens til å ha mange spor, så for en gitt tidsperiode kan det hende du må velge hvilken samtale du vil se fra fem eller flere samtaler samtidig.

I likhet med en regional konferanse, tilbyr store konferanser ofte en rekke verksteder før eller etter konferansen. I tillegg til workshops inkluderer mange også praktiske laboratorier under konferansen. Labs er vanligvis inkludert i prisen på konferansen og gir en stor sjanse til å faktisk prøve ut teknologiene du hører om på konferansen.

Mange av disse konferansene blir kastet av store teknologiselskaper, for eksempel Microsofts Build-konferanse og Apples WWDC.

Noen få eksempler inkluderer

  • Oscon: Portland, Oregon Bygg: sted endres hvert år WWDC: San Francisco, California

GitHub Universe

GitHub Universe er flaggskipskonferansen for GitHub. Det holdes årlig i byen der GitHubs hovedkvarter er bosatt, San Francisco, California. Konferansen arrangeres vanligvis høsten rundt oktober eller november.

Som GitHub beskriver det,


GitHub Universe er en konferanse for utbyggere, planleggere og ledere som definerer fremtiden til programvare.

Denne konferansen er hvor GitHub vanligvis gjør sine største kunngjøringer av året under grunntonene. Det tiltrekker seg kjente foredragsholdere fra fremtredende programvareselskaper.

I 2018 hadde konferansen rundt 1 800 deltakere som deltok på tre spor med samtaler. Kostnaden for konferansen er rimelig, rundt $ 99 per person, eller $ 199 hvis du også deltar på verkstedene.

GitHub Satellite

GitHub Satellite konferanser er en avlegger av GitHub Universe. De tar med seg en GitHub universalkonferanse til steder rundt om i verden.

Holdt en gang i året, har forbi satellitter blitt holdt på steder som Berlin, Tokyo og London.

GitHub Constellation

GitHub Constellation er en serie med små samfunnsarrangementer som holdes flere ganger i året rundt om i verden. Disse begivenhetene fokuserer på lokalsamfunnet og har ofte foredragsholdere som er lokale i området. De er vanligvis gratis og forekommer over ett eller to kvelder. Det er ikke heldagskonferanser som Satellite og Universe.

Git Merge

Git Merge, er en konferanse sponset av GitHub, men fokusert på Git-versjonskontrollverktøyet og menneskene som bruker den hver dag. Som GitHub uttrykker det,


Gjennom tekniske økter og praktiske workshops vil utviklere og team på alle erfaringsnivåer finne nye måter å bruke, bygge videre på og skalere Git på.

Konferansen inneholder en praktisk konferansedag med workshops med fokus på en rekke Git-emner. Denne konferansen er en flott en for å lære mer om Git og forbedre Git-ferdighetene dine.

  1. Nettdesign og utviklingThe GitHub Marketplace

Av Sarah Guthals

Mange verktøy utvider eller integreres med GitHub. En god måte å finne verktøy å bruke med GitHub er GitHub Marketplace. GitHub Marketplace er en katalog med verktøy og apper gruppert i følgende kategorier:

  • Chat Kodekvalitet Kode anmeldelse Kontinuerlig integrering Avhengighetsstyring Utplassering læring lokalisering Mobil Overvåkning Prosjektledelse publisering Nylig lagt til Sikkerhet Brukerstøtte testing verktøy

Marketplace er en flott måte å finne en app for enhver situasjon på GitHub. Å kjøpe eller installere apper via Marketplace har to viktige fordeler: enkel fakturering og installasjon og godkjenningsprosessen.

Fakturering er enkelt på GitHub Marketplace

For apper i GitHub Marketplace som krever betaling, er det en strømlinjeformet flyt å installere appen gjennom Marketplace fordi du kan bruke GitHub-betalingsinfo. På den måten har du ikke kontakt med fem forskjellige betalingsleverandører når du kjøper fem forskjellige apper som skal brukes med GitHub.

Hvis du har en gratis GitHub-konto, kan det hende du ikke har konfigurert betalingsinformasjonen din i GitHub. For å sette opp en betalingsmåte, klikker du avataren din øverst til høyre på GitHub.com og klikker Innstillinger. Fra denne siden klikker du Fakturering fra listen til venstre. Her kan du klikke på Legg til betalingsmetode, som vist.

GitHub-faktureringsskjema

Vetting-prosessen for GitHub Marketplace

En av fordelene med å installere en applikasjon fra Marketplace er at disse appene må oppfylle visse krav før GitHub vil liste dem på Marketplace. Kravene er med på å sikre en høyere standard for kvalitet og sikkerhet med appene; som hjelper deg med å sikre at disse appene er nyttige (ingen Fart-apper) og er sikre.

For øyeblikket krever ikke en GitHub-handling noen vurdering for å være oppført på GitHub Marketplace, noe som betyr at det kan være litt mer risikabelt å installere en handling fra noen du ikke kjenner.

En app må oppfylle fire hovedkategorikrav før den blir oppført på Marketplace:

  • Brukeropplevelse: Dette korte settet med ni krav inkluderer ting som appen må ha et visst antall brukere og installasjoner allerede. Den inkluderer også noen krav rundt atferden til appen, for eksempel at appen må inkludere lenker til dokumentasjon, den kan ikke aktivt overtale brukere vekk fra GitHub, og den må gi verdi til kundene. Merke og liste: Dette settet med retningslinjer og anbefalinger fokuserer rundt merkevarebygging av appen din og appens oppføring. Hver app må ha sin egen logo. Hvis appen bruker GitHubs logo, må den følge GitHubs logoer og bruksanvisninger. Merke- og oppføringsdelen på Krav-siden har lenker til ytterligere retningslinjer for logo og beskrivelse. Som du ser tar GitHub oppføringen av apper på Marketplace på alvor. Sikkerhet: GitHub vil gjennomføre en sikkerhetsgjennomgang av apper før de blir oppført på markedet. Et eget dokument med sikkerhetsmetoder og flere detaljer om sikkerhetsgjennomgangen er tilgjengelig. Faktureringsstrømmer: Hver app på Marketplace må integrere faktureringsstrømmer ved å bruke netthook-hendelsen GitHub Marketplace. Dette kravet sikrer at folk kan kjøpe et abonnement på appen din og kansellere abonnementet med betalingsinfo de allerede har på GitHub. Det sikrer også at endringer som er gjort gjennom GitHub, gjenspeiles umiddelbart på appens eget nettsted.

Slik viser du appen din på GitHub Marketplace

Å få din egen app oppført på Marketplace kan øke den potensielle målgruppen for applikasjonen din. Å oppføre appen din krever imidlertid at den oppfyller GitHubs krav og mottar godkjenning.

For å starte prosessen med å liste opp en app, klikker du på koblingen Send inn verktøyet for gjennomgang nederst på markedsplassen Landingsside eller navigerer til den nye siden på GitHub markedsplass i nettleseren.

Denne siden viser applikasjonene dine som du kan gjøre om til Marketplace-oppføringer, som vist i figuren nedenfor.

GitHub-appoppføringer

Klikk på Opprett utkastliste ved siden av appen du vil liste på Marketplace for å starte prosessen. Dette fører deg til en side hvor du kan angi et navn for oppføringen og velge en av markedskategoriene for appen din, som vist.

GitHub-appskjema

Hvis du lagrer utkastet til oppføringen din, men tilfeldigvis lukker nettleseren, kan du komme tilbake til oppføringen i nettleseren.

Etter at du har fylt ut disse detaljene, klikker du Lagre og legger til flere detaljer for å lagre et utkast til oppføringen din og går videre til neste sett trinn, som vist.

Innlevering av GitHub Marketplace

Disse trinnene inkluderer

  1. Legg til kontaktinfo. Denne informasjonen er et sett med tre e-postadresser: Teknisk kundeemne, markedsføringsledelse og økonomiledning. Fyll ut oppføringsbeskrivelsen. Dette området er der du fyller ut flere detaljer, for eksempel en produktbeskrivelse, logo og skjermbilder. Informasjonen her vil vises på Marketplace-siden for applikasjonen din. Sett opp planer og priser. Det er her du kan sette opp en eller flere prisplaner, inkludert muligheten til å lage en gratis plan, en månedlig plan eller en månedlig per brukerplan. Du kan også spesifisere om en plan inkluderer en 14-dagers gratis prøveperiode. Sett opp nettkrok. Dette trinnet lar deg spesifisere en URL der Marketplace-hendelser skal sendes via en HTTP POST-forespørsel. Nettkroken vil sende deg informasjon om hendelser, for eksempel kjøp, kanselleringer og endringer som oppgraderinger og nedgraderinger. Godta markedsutvikleravtalen. For å kunne vise appen din på markedet må du godta Marketplace Developer Agreement. Klikk på knappen Send for vurdering. GitHub-ansatte vil gjennomgå innsendingen din for å sikre at den oppfyller kravene som skal vises på Marketplace.

Vurder vanlige apper å installere

Her er noen av de vanligste og nyttige GitHub-appene som du kanskje vil vurdere å installere.

Kontinuerlig integrering

Kontinuerlig integrering (CI) -apper bygger og tester koden automatisk hver gang du skyver den til GitHub. Hvis du har en CI-app, for eksempel AppVeyor, installert på depotet ditt, vil du se status for sjekken nederst på hver trekkforespørsel, som vist.

GitHub AppVeyor CI

Hvis du er eier av depotet, kan du også spesifisere om kontroller må passere før grenen kan slås sammen til hovedgrenen. Bare gå inn på Innstillinger-fanen. Hvis du allerede har noen regler for mastergrenen, klikker du på rediger; Ellers klikker du på Legg til regel. Derfra kan du bla nedover og velge Krever statuskontroller for å passere før du fusjonerer.

Kodekvalitet

Appkoder for kodekvalitet gjennomgår automatisk koden din med kontroller av stil, kvalitet, sikkerhet og testdekning. Disse appene kan være veldig nyttige for å sikre at koden din holdes til en høy standard. Med velutstyrt og kvalitetskode er det mindre sannsynlig at du introduserer eller går glipp av feil. Hvis du for eksempel krever at alle krøllete seler er på nye linjer og innrykket med en fane per nestet seler, vil du sannsynligvis kunne se når noe er feil. For eksempel sjekker Rubocop stilen til Ruby-koden mens den bygger og gir deg stiltilbakemeldinger, for eksempel foringsrør for metodenavn.

En annen nyttig type kodekvalitetsapper er kodedekningsappene, for eksempel Codecov. I figuren nedenfor vises Codecov og apper som den som kommenterer trekkforespørsler med hvor mye av koden som dekkes av testscenarier, noe som hjelper deg med å sikre at koden din forblir godt testet.

GitHub Codecov-appen

lokalisering

Lokaliseringsapper kan gjøre det lettere å publisere appen din på mange språk. For eksempel vil Crowdin-appen koble depotet ditt til en Crowdin-konto der folk fra hele verden kan hjelpe deg med å oversette dokumentasjonen din og eventuelle skrevne ord i programvaren din (for eksempel på knapper eller i menyer). Med mer enn 20 000 mennesker som bidrar til oversettelser, vil Crowdin-appen automatisk åpne en trekkforespørsel på depotet ditt med nye oversettelser når den har nådd en terskel for nøyaktighet, og likevel gi deg en sjanse til å se gjennom og slå sammen. For open source-prosjekter er Crowdin gratis!

Overvåkning

Overvåking av apper hjelper til med å måle ytelse, spore feil og spore avhengigheter i koden din. Greenkeeper er for eksempel en sanntidsvarslingsapp som gir deg oppdateringer og endringer for JavaScript-avhengigheter. Denne figuren viser Greenkeeper i aksjon, og åpner en trekkforespørsel for å oppdatere eslint til den nyeste versjonen.

GitHub Greenkeeper-appen

Avhengighetsstyring

Moderne apputvikling i dag er sterkt avhengig av offentlige pakkesjefer for å trekke inn og administrere avhengigheter. En typisk app kan ha dusinvis, om ikke hundrevis av avhengigheter. Det kan være vanskelig å spore hvilke av disse avhengighetene er oppdaterte. Github-apper som Dependabot sjekker for å forsikre deg om at avhengighetene dine er oppdaterte og sender inn trekkforespørsler for å oppdatere dem som ikke er det.

Noen ganger vil du ikke ha alle dine avhengigheter av et offentlig pakkeregister. For eksempel, hvis du jobber i et selskap, kan du ha interne pakker som bør forbli private. Et privat pakkeregisterverktøy, for eksempel MyGet, er nyttig i dette tilfellet. MyGet jobber med NuGet-pakker og lar deg sette opp en policy der pushing til en bestemt gren vil sette i gang en build og grenen blir distribuert til en tilpasset NuGet-feed som er vert på MyGet.

testing

Testing av programvare er en viktig del av programvaren utvikling livssyklus. Gode ​​testere utvikler testplaner for å sikre at testere gjør en god jobb med å teste hver utgivelse. Å administrere testplaner og holde oversikt over statusen til testkjøring er en viktig del av kvalitetssikring. TestQuality-appen integreres med GitHub for å hjelpe utviklere og testere med å opprette, kjøre, koordinere og overvåke testoppgaver for programvare.

læring

En flott måte å lære GitHub på er å installere GitHub Learning Lab fra Marketplace. Installere Learning Lab installere en bot som leder deg gjennom interaktive leksjoner om hvordan du bruker GitHub gjennom et sett med oppgaver du fullfører. Laboratoriet er gratis og lar deg ta så mange kurs du vil i ditt eget tempo.