Uneori veti identifica continut deja existent, care ar avea sens sa migrati catre MDN Web Docs din alte parti. Acest articol acopera ce tipuri de continut ar putea avea sens sa migreze, daca ar trebui sa migrati continut sau nu si ce flux de lucru sa utilizati pentru a efectua migrarea.

Ce continut ar avea sens sa migrezi?

Exista o serie de tipuri de continut pe care ar putea avea sens sa migreze catre MDN Web Docs:

  • Tutoriale / Ghiduri: informatii practice despre utilizarea unei tehnologii. Acestea sunt utile pe MDN Web Docs intr-o varietate de locuri, in functie de nivel si acoperire (de exemplu, Folosind Fetch, Crearea de hyperlink-uri).
  • Explanatori / articole conceptuale: acestea se ocupa in general de explicarea conceptelor la nivel inalt, cum ar fi de ce un API este structurat asa cum este, ce probleme este conceput sa rezolve etc. Acestea ar avea sens ca articole „Concepte” (de exemplu, concepte WebVR) .
  • Exemple de coduri: MDN Web Docs apreciaza cu adevarat exemplele de coduri bune, indiferent daca este vorba de fragmente de cod pe care sa le introduceti in articole de referinta sau exemple complete de conectare. Suntem bucurosi sa intampinam exemple de coduri bune in repos-urile noastre GitHub, fie ca exemple independente, fie ca parte din repo-ul nostru de exemple interactive.

Continut care nu are sens sa migrezi catre MDN Web Docs:

  • Studii de caz indelungate
  • Documentatia produsului
  • Continut promotional

De ce ati migra continutul?

Daca exista deja un continut bun pentru dezvoltatori, este logic sa-l migrati la MDN Web Docs din mai multe motive:

  • SEO: MDN Web Docs este un site foarte popular – plasarea continutului acolo este o modalitate buna de a-l face mai usor de gasit.
  • Nu reinventeaza roata: documentatia MDN Web Docs este mandra ca este completa, ceea ce inseamna ca va trebui sa scriem toate referintele si tutorialele esentiale pe site, mai degraba decat sa ne conectam la alte locuri. Punerea unui tutorial existent aici inseamna ca nu va trebui sa-l scriem 😉
  • Revizuiri si intretinere: daca va puneti continutul pe MDN Web Docs, veti beneficia de sprijinul deplin al echipei si al comunitatii noastre de scriitori pentru a ajuta la revizuirea, editarea si intretinerea lucrarii.

Ar trebui sa migrati continutul?

Daca continutul este de inalta calitate si indeplineste criteriile de tip de continut de mai sus, atunci suna ca un lucru bun sa il migrezi. Cu toate acestea, trebuie sa luati in considerare mai intai punctele de mai jos inainte de a face o miscare:

Flux de lucru pentru migrare

Ceea ce urmeaza este un exemplu de flux de lucru pentru migrarea continutului in MDN Web Docs. Am migrat un cod de solicitare de plata W3C catre MDN, asa cum este inregistrat in acest numar GitHub.

  1. Identificati resursa care urmeaza sa fie migrata.
  2. Identificati cine detine continutul si discutati cu ei si cu comunitatea lor asociata pentru a va asigura ca mutarea continutului nu va fi o problema.
  3. Identificati un contact MDN Web Docs care va poate ajuta cu migrarea. Daca aveti dubii, cereti ajutor.
  4. Uitandu-ne la repozitia noastra de continut GitHub, identificati locatia in care ar trebui sa fie plasat continutul, asigurandu-va ca nu dubleaza continutul existent (a se vedea mai sus).
  5. Mutati continutul peste, facand modificarile necesare, astfel incat sa se potriveasca stilului MDN.
  6. Solicitati o revizuire de la echipa / comunitatea MDN
  7. Redirectionati resursa veche catre noua locatie, dupa caz.