Deagh chleachdaidhean gus bathar-bog an-asgaidh agus fosgailte a leasachadh: Sgrìobhainnean

Sgrìobhainnean: Deagh chleachdaidhean gus bathar-bog an-asgaidh agus fosgailte a leasachadh

Sgrìobhainnean: Deagh chleachdaidhean gus bathar-bog an-asgaidh agus fosgailte a leasachadh

La sgrìobhainnean tha agus bu chòir a bhith na phàirt bunaiteach den pròiseas cruthachail agus dealbhadh de ghnìomhachd daonna uile, agus barrachd ann an raon teicneòlais, gu sònraichte ann an raon na Leasachadh bathar-bog.

El adhbhar a h-uile sgrìobhainn feumaidh gur e esan teagasg treas phàrtaidhean (luchd-cleachdaidh, rianadairean, luchd-gleidhidh, no luchd-leasachaidh eile), nach àbhaist a bhith eòlach air an toradh (còd, tagradh no siostam), ciamar a tha e air a chruthachadh a structar, a ghnìomhachd agus eadhon ma ghabhas e dèanamh, an adhbhar airson a chruthachadh agus a dhòigh dealbhaidh agus obrachaidh.

Deagh chleachdaidhean: Sgrìobhainnean - Ro-ràdh

A bharrachd air an sin, ann an cùis sònraichte de Tha sgrìobhainnean bathar-bog an-asgaidh deatamach, seach gu bheil e a ’ceadachadh làn ghealladh a thoirt dha na gluasad fiosrachaidh agus cumhachd riatanach airson coileanadh riarachail an 4 saorsa air a bhrosnachadh leis, a tha:

  • 0: An saorsa am prògram a ruith ge bith dè a tha thu ag iarraidh, airson adhbhar sam bith.
  • 1: An saorsa faighinn gu prògram agus sgrùdadh a dhèanamh air, agus atharrachadh no atharrachadh airson do bhuannachd fhèin.
  • 2: An saorsa leth-bhreacan a cho-roinn no ath-riarachadh gus an aon rud a sgaoileadh agus / no daoine eile a chuideachadh.
  • 3: An saorsa lethbhric de na dreachan atharraichte agad a sgaoileadh gu treas phàrtaidhean.

Tha deagh sgrìobhainn ga dhèanamh comasach, mar sin, gum bi an toradh cruthaichte:

  • Tha e air a chleachdadh gu ceart, agus tha e nas fhasa a theagasg agus ionnsachadh.
  • Tuigear gu mionaideach leis an fheadhainn a tha airson atharrachadh gus a leasachadh no atharrachadh.
  • A bhith air a cho-roinn agus air fhaighinn le barrachd misneachd, am measg gach neach a tha eòlach agus coigrich.
  • Biodh mais nas fheàrr am measg a ’phobaill.

Deagh chleachdaidhean: Sgrìobhainnean - Readme

Deagh chleachdaidhean: Sgrìobhainnean

Bun-bheachdan

Ann an cùis Leasachadh bathar-bog an-asgaidh agus stòr fosgailte, san fharsaingeachd, prìomh luchd-cleachdaidh na sgrìobhainnean an coimeas ri dealbhadh toraidh, is iadsan a tha no a bhios, an le uallach airson cumail suas den aon rud. Agus às aonais sgrìobhainnean math no às aonais, is e an aon roghainn obrachaidh eile a bhith ga sgrùdadh gu dìreach, a choileanadh tuigsinn a dhealbhadh agus a dhleastanas.

Gun a bhith a ’cruthachadh sgrìobhainnean math nuair a thig e gu leasaich bathar-bog an-asgaidh, Open Source no bathar-bog de sheòrsa sam bith eile, a chuir chun luchd-faighinn a dh ’fhaodadh a bhith aige (luchd-cleachdaidh, rianadairean, luchd-gleidhidh, no luchd-leasachaidh eile) gus slighe a lorg tro jungle gun mhapa no combaist.

Cruthaich sgrìobhainnean math airson gach fear Bathar-bog an-asgaidh, Open Source tha e cuideachd buannachdail, oir, ged-tà tha cosgais aig clàradhIs fhiach an tasgadh, ma thèid a dhèanamh ceart. Air sgàth, saoghal na bathar-bog làn de sgeulachdan mu dheidhinn còdan dìleab prògraman, tagraidhean no siostaman seann no gnàthach, nach eil ach glè bheag de dhaoine a ’miannachadh suathadh, oir cha mhòr nach eil duine a’ tuigsinn. Bidh luchd-prògramaidh ag amas air còd a chruthachadh agus gun a bhith ga chlàradh gu ceart agus gu tur. Agus feumar seo a leigheas.

Deagh chleachdaidhean air sgrìobhainnean ann am faidhlichean teacsa README

Ann an cùis Bathar-bog an-asgaidh agus stòr fosgailte, bidh sgrìobhainnean gu tric air an cuingealachadh ri faidhlichean teacsa, nuair a thèid a chruthachadh le daoine fa leth no buidhnean beaga de luchd-prògramaidh no coimhearsnachdan. Ach, eadhon a ’cruthachadh sgrìobhainnean sìmplidh a’ cleachdadh sìmplidh faidhle teacsa README.md (no .txt) faodaidh tu do chuid cleachdaidhean as fheàrr no math, molaidhean no stiùireadh feumail airson cruthachadh gus fiosrachadh as coileanta agus mionaideach a thoirt do threas phàrtaidhean mu na chaidh a chruthachadh.

Airson an artaigil againn, tha sinn air an Deagh chleachdaidhean air a chruthachadh agus air fhoillseachadh leis an "Iomairt Còd airson Leasachadh" del Banca Eadar-Ameireagaidh Leasachaidh, a tha ann an dòigh geàrr-chunntas ag innse dhuinn gu bheil deagh sgrìobhainnean stèidhichte air a faidhle teacsa README.md (no .txt) Feumaidh e a bhith air a structaradh mar a leanas:

Structar faidhle README air a mholadh

  • Tuairisgeul agus co-theacsa: Earrann far am feum thu cunntas a thoirt air comasan, an co-theacsa far an deach a leasachadh agus na duilgheadasan leasachaidh a chuidich e le fuasgladh.
  • Stiùireadh Cleachdaiche: Bu chòir iomradh a thoirt air earrann far am bu chòir stiùireadh a thoirt don neach-cleachdaidh deireannach air mar a thòisicheas tu a ’cleachdadh an inneal didseatach.
  • Stiùireadh stàlaidh: Bu chòir iomradh a thoirt air an roinn far a bheil an stiùireadh stàlaidh gus an inneal didseatach ath-chleachdadh agus a rèiteachadh. Tha an roinn seo airson luchd-leasachaidh.
  • Ùghdaran Earrann far am feumar creideasan a thoirt do cho-oibrichean an inneil.
  • Cead airson a ’chòd inneal: Feumar roinn far a bheil na ceadan a chaidh a thoirt do threas phàrtaidhean an inneal didseatach ath-chleachdadh.
  • Cead airson sgrìobhainnean an inneil: Feumar iomradh a thoirt air roinn far a bheil an seòrsa cead a tha anns na sgrìobhainnean a chaidh a chruthachadh.

Annta sin deagh chleachdaidhean, tha iad cuideachd a ’moladh cuir ris an Sgrìobhainnean faidhle README gus a dhèanamh nas iomlaine, na h-earrannan a leanas:

  • Mar a chuireas tu ris: Earrann a tha a ’mìneachadh do luchd-leasachaidh ùra am pròiseas gus cuir ri pròiseactan.
  • Còd giùlain: Tha an earrann a tha a ’mìneachadh a’ chòd giùlain a ’stèidheachadh nan gnàthasan sòisealta, riaghailtean agus dleastanasan a dh’ fheumas daoine fa leth agus buidhnean a leantainn nuair a bhios iad ag eadar-obrachadh ann an dòigh sam bith leis an inneal didseatach no a ’choimhearsnachd aca.
  • Bràistean: Earrann a ’sealltainn bràistean (ìomhaighean beaga freumhaichte ann an README.md) a tha a’ sònrachadh ann an dòigh a tha furasta a leughadh agus pongail inbhe an inneil.
  • Tionndadh: Earrann a tha a ’nochdadh liosta de na dreachan den inneal didseatach agus na comasan a chaidh a chur ris gach dreach.
  • Buidheachas: Earrann anns a bheil aithne do dhaoine no bhuidhnean eile a chuir gu ìre ris a ’phròiseact.

Gus am fiosrachadh seo a leudachadh, air an Deagh chleachdaidhean ann an cùisean de Sgrìobhainnean airson leasachadh Bathar-bog an-asgaidh, leis an "Iomairt Còd airson Leasachadh" del Banca Eadar-Ameireagaidh Leasachaidh faodaidh tu briogadh air a ’cheangal a leanas: Sgrìobhainnean - Stiùireadh airson innealan didseatach fhoillseachadh. Agus ann am foillseachaidhean eile nì sinn sgrùdadh air a ’phàirt a tha a’ toirt iomradh air an deagh chleachdaidhean air an measadh agus ceadachd del Bathar-bog an-asgaidh agus fosgailte iad fhèin.

Co-dhùnadh

Co-dhùnadh

Tha sinn an dòchas gu bheil an tè seo "post beag feumail" mu dheidhinn «Buenas prácticas» ann an raon na «documentación» a chruthachadh nuair a bhios tu a ’leasachadh «Software libre y abierto», bi ùidh mhòr agus goireasachd, airson an iomlan «Comunidad de Software Libre y Código Abierto» agus a ’cur gu mòr ri sgaoileadh an eag-shiostam iongantach, gigantic agus a tha a’ sìor fhàs de thagraidhean de agus airson «GNU/Linux».

Agus airson tuilleadh fiosrachaidh, na bi leisg an-còmhnaidh tadhal air gin Leabharlann air-loidhne como OpenLibra y jedit a leughadh leabhraichean (PDFs) air a ’chuspair seo no air feadhainn eile raointean eòlais. Airson a-nis, ma chòrd seo riut «publicación», na leig seachad a roinneadh le càch, anns do Làraich-lìn, seanalan, buidhnean no coimhearsnachdan as fheàrr leat de lìonraidhean sòisealta, mas fheàrr an-asgaidh agus fosgailte mar Mastodon, no tèarainte is prìobhaideach mar sin teileagram.

No dìreach tadhal air an duilleag dachaigh againn aig BhoLinux no a dhol còmhla ris an t-Sianal oifigeil Teileagram bho DesdeLinux a bhith a ’leughadh agus a’ bhòtadh airson seo no foillseachaidhean inntinneach eile air «Software Libre», «Código Abierto», «GNU/Linux» agus cuspairean eile co-cheangailte «Informática y la Computación», agus an «Actualidad tecnológica».


Tha susbaint an artaigil a ’cumail ri na prionnsapalan againn de moraltachd deasachaidh. Gus aithris a dhèanamh air mearachd cliog an seo.

Bi a 'chiad fhear a thog beachd

Fàg do bheachd

Seòladh-d cha tèid fhoillseachadh.

*

*

  1. Uallach airson an dàta: Miguel Ángel Gatón
  2. Adhbhar an dàta: Smachd air SPAM, riaghladh bheachdan.
  3. Dìleab: Do chead
  4. Conaltradh an dàta: Cha tèid an dàta a thoirt do threas phàrtaidhean ach a-mhàin fo dhleastanas laghail.
  5. Stòradh dàta: Stòr-dàta air a chumail le Occentus Networks (EU)
  6. Còraichean: Aig àm sam bith faodaidh tu am fiosrachadh agad a chuingealachadh, fhaighinn air ais agus a dhubhadh às.