દસ્તાવેજીકરણમાં યોગદાન
WordPress Playground ની દસ્તાવેજીકરણ સાઇટ તમારા જેવા સ્વયંસેવકો દ્વારા સંચાલિત છે — અને તેમને તમારી મદદ ગમે છે।
WordPress/wordpress-playground રેપોઝિટરીમાં દસ્તાવેજીકરણ સંબંધિત તમામ ઇશ્યૂઝને [Type] Documentation અથવા [Type] Developer Documentation લેબલ આપવામાં આવે છે. ખુલ્લા ઇશ્યૂઝની યાદી જુઓ અને જે ઇશ્યૂ પર તમે કામ કરવાનું ઇચ્છો તે પસંદ કરો. અન્યથા, જો તમને લાગે કે વર્તમાન દસ્તાવેજીકરણમાં કંઈક ગૂમ છે, તો તમારી સલાહ પર ચર્ચા કરવા માટે નવો ઇશ્યૂ ખોલો.
હું કેવી રીતે યોગદાન આપી શકું?
તમે પ્રોજેક્ટ રિપોઝિટરીમાં ઇશ્યૂ ખોલીને શું ઉમેરવું છે કે શું બદલવું છે તેનું વર્ણન કરી શકો છો।
તમને અનુકૂળ હોય તો ઇશ્યૂના વર્ણનમાં જ કન્ટેન્ટ લખી દો; પછીનું કામ પ્રોજેક્ટ યોગદાનકર્તાઓ સંભાળી લેશે।
શું તમે દસ્તાવેજીકરણને તમારી ભાષામાં જોવા માંગો છો? તો ટ્રાન્સલેશન વિભાગ જુઓ।
રેપો ફૉર્ક કરવો, લોકલી ફાઇલો એડિટ કરવી અને Pull Request મોકલવો
જો તમે માર્કડાઉનથી પરિચિત છો, તો તમે wordpress-playground રેપોને ફોર્ક કરી શકો છો અને પુલ રિક્વેસ્ટ સબમિટ કરીને ફેરફારો અને નવા દસ્તાવેજીકરણ પૃષ્ઠોનો પ્રસ્તાવ મૂકી શકો છો.
WordPress/wordpress-playground રેપોઝિટરીમાં અનુવાદિત પેજ સાથે નવી બ્રાન્ચ બનાવી PR ખોલવાની પ્રક્રિયા બાકી WordPress રેપોઝિટરીઓ (જેમ કે Gutenberg) જેવી જ છે: https://developer.wordpress.org/block-editor/contributors/code/git-workflow/
દસ્તાવેજીકરણની .md ફાઇલો Playground ની GitHub રેપોઝિટરીમાં રાખેલી છે: અંગ્રેજી માટે /packages/docs/site/docs અને અન્ય ભાષાઓ માટે /packages/docs/site/i18n।
બ્રાઉઝરમાં સીધું એડિટ કરવું
જો તમે GitHub માં લૉગઇન હો, તો GitHub UI માંથી જ ફાઇલમાં ફેરફાર કરી શકો છો (અથવા નવી ફાઇલ ઉમેરી શકો છો) અને સીધો PR મોકલી શકો છો:
- જે પેજ એડિટ કરવું છે તે શોધો, અથવા જે ચેપ્ટરમાં નવું પેજ ઉમેરવું છે તે ડિરેક્ટરી શોધો।
- નવી ફાઇલ ઉમેરવા માટે Add files બટન ક્લિક કરો; અથવા કોઈ હાલની ફાઇલ ખોલીને પેન્સિલ (edit) આઇકન ક્લિક કરો।
- GitHub તમારા ફેરફારો માટે રેપોઝિટરી ફૉრკ કરવા અને નવી બ્રાન્ચ બનાવવા કહેશે।
- એડિટર ખુલશે, જ્યાં તમે ફેરફારો કરી શકશો।
- કામ પૂરૂં થયા બાદ Commit changes ક્લિક કરો અને Pull Request મોકલો।
બસ એટલું જ! હવે તમે WordPress Playground દસ્તાવેજીકરણમાં યોગદાન આપી દીધું।
આ રીતથી તમને રેપો ક્લોન કરવાની, લોકલ ડેવલપમેન્ટ એન્વાયરમેન્ટ બનાવવાની અથવા કોઈ કમાન્ડ ચલાવવાની જરૂર નથી। ખામી એ છે કે તમે ફેરફારોનું પ્રીવ્યૂ આગળથી જોઈ શકશો નહીં — Pull Request મોકલતા પહેલા ફેરફારો કેવી રીતે પ્રીવ્યૂ કરવાના તે નીચે જુઓ।
લોકલ પ્રીવ્યૂ
રેપોઝિટરી ક્લોન કરો અને તમારા ડિવાઇસ પર સંબંધિત ડિરેક્ટરીમાં જાઓ. હવે નીચેની કમાન્ડ ચલાવો:
npm install
npm run build:docs
npm run dev:docs
+```
દસ્તાવેજીકરણ સાઇટ નવા બ્રાઉઝર ટૅબમાં ખુલશે અને દરેક ફેરફાર બાદ આપમેળે રિફ્રેશ થશે. હવે તમારા કોડ એડિટરમાં સંબંધિત ફાઇલ એડિટ કરતા રહો અને બદલાવ રિયલ-ટાઇમમાં ચકાસો।
<!-- The documentation site opens in a new browser tab and refreshes automatically with each change. Continue to edit the relevant file in your code editor and test the changes in real-time. -->