99msgstr ""
1010"Project-Id-Version : pyOpenSci Python Package Guide \n "
1111"Report-Msgid-Bugs-To : \n "
12- "POT-Creation-Date : 2024-07-03 16:27-0400 \n "
12+ "POT-Creation-Date : 2024-08-02 18:04+0900 \n "
1313"PO-Revision-Date : YEAR-MO-DA HO:MI+ZONE\n "
1414"Last-Translator : FULL NAME <EMAIL@ADDRESS>\n "
1515"Language : es\n "
@@ -119,201 +119,222 @@ msgstr ""
119119#: ../../CONTRIBUTING.md:35
120120msgid ""
121121"Independently of the approach you choose, the first step is to fork the "
122- "Python Packaging Guide repository into your personal GitHub space."
122+ "Python Packaging Guide repository into your personal GitHub space. To "
123+ "\" fork\" a repository in GitHub means to create a copy of the main "
124+ "repository, or repo, that you have complete control over and can modify "
125+ "as you see fit."
123126msgstr ""
124127
125128#: ../../CONTRIBUTING.md:37
126- msgid ""
127- "*__TODO__: This section should show a beginner user how to fork a "
128- "repository in GitHub.*"
129+ msgid "To fork a repo,"
129130msgstr ""
130131
131132#: ../../CONTRIBUTING.md:39
132- msgid "Contributing via the GitHub website "
133+ msgid "Make sure you are logged into GitHub. "
133134msgstr ""
134135
135136#: ../../CONTRIBUTING.md:41
136- msgid "How to edit a MarkDown file"
137+ msgid ""
138+ "Go to the repo you would like to fork, in this case the [Python Packaging"
139+ " Guide](https://www.github.com/pyopensci/python-package-guide) repo."
137140msgstr ""
138141
139142#: ../../CONTRIBUTING.md:43
140143msgid ""
144+ "In the top right-hand corner of the page there is a 'Fork' button. Click "
145+ "that button. You will be brought to a new page where you will 'Create a "
146+ "new fork'. Feel free to keep all the default inputs and click 'Create "
147+ "fork'. This will create a copy of the repo at "
148+ "`https://github.com/<username>/python-package-guide`, where `<username>` "
149+ "is your GitHub username."
150+ msgstr ""
151+
152+ #: ../../CONTRIBUTING.md:47
153+ msgid "Contributing via the GitHub website"
154+ msgstr ""
155+
156+ #: ../../CONTRIBUTING.md:49
157+ msgid "How to edit a MarkDown file"
158+ msgstr ""
159+
160+ #: ../../CONTRIBUTING.md:51
161+ msgid ""
141162"*__TODO__: This section should show how to use the GitHub interface to "
142163"edit and previewing a Markdown file.*"
143164msgstr ""
144165
145- #: ../../CONTRIBUTING.md:45
166+ #: ../../CONTRIBUTING.md:53
146167msgid "How to commit your changes"
147168msgstr ""
148169
149- #: ../../CONTRIBUTING.md:47
170+ #: ../../CONTRIBUTING.md:55
150171msgid ""
151172"*__TODO__: This section should show how to commit changes via the GitHub "
152173"interface.*"
153174msgstr ""
154175
155- #: ../../CONTRIBUTING.md:49
176+ #: ../../CONTRIBUTING.md:57
156177msgid "Contributing locally on your computer"
157178msgstr ""
158179
159- #: ../../CONTRIBUTING.md:51
180+ #: ../../CONTRIBUTING.md:59
160181msgid "Clone your forked repository"
161182msgstr ""
162183
163- #: ../../CONTRIBUTING.md:53
184+ #: ../../CONTRIBUTING.md:61
164185msgid ""
165186"*__TODO__: This section should show how to clone a repository from GitHub"
166187" into your computer.*"
167188msgstr ""
168189
169- #: ../../CONTRIBUTING.md:55
190+ #: ../../CONTRIBUTING.md:63
170191msgid "Create a new branch"
171192msgstr ""
172193
173- #: ../../CONTRIBUTING.md:57
194+ #: ../../CONTRIBUTING.md:65
174195msgid "*__TODO__: This section should show how to create a new branch.*"
175196msgstr ""
176197
177- #: ../../CONTRIBUTING.md:59
198+ #: ../../CONTRIBUTING.md:67
178199msgid "Create a virtual environment"
179200msgstr ""
180201
181- #: ../../CONTRIBUTING.md:61
202+ #: ../../CONTRIBUTING.md:69
182203msgid ""
183204"*__TODO__: This section should show how to create a virtual environment "
184205"using venv.*"
185206msgstr ""
186207
187- #: ../../CONTRIBUTING.md:63
208+ #: ../../CONTRIBUTING.md:71
188209msgid "Install the development dependencies"
189210msgstr ""
190211
191- #: ../../CONTRIBUTING.md:65
212+ #: ../../CONTRIBUTING.md:73
192213msgid ""
193214"*__TODO__: This section should show how to install the development "
194215"dependencies defined in pyproject.toml.*"
195216msgstr ""
196217
197- #: ../../CONTRIBUTING.md:67
218+ #: ../../CONTRIBUTING.md:75
198219msgid "Commit your changes"
199220msgstr ""
200221
201- #: ../../CONTRIBUTING.md:69
222+ #: ../../CONTRIBUTING.md:77
202223msgid ""
203224"*__TODO__: This section should describe how to commit from the command "
204225"line.*"
205226msgstr ""
206227
207- #: ../../CONTRIBUTING.md:71
228+ #: ../../CONTRIBUTING.md:79
208229msgid "How to build the guide locally"
209230msgstr ""
210231
211- #: ../../CONTRIBUTING.md:73
232+ #: ../../CONTRIBUTING.md:81
212233msgid ""
213234"*__TODO__: This section should describe the different sessions in nox "
214235"related to building the docs: docs, docs-test, docs-live. It should also "
215236"show how to see the guide built locally, by opening the right file in the"
216237" browser or using the live version from docs-live*"
217238msgstr ""
218239
219- #: ../../CONTRIBUTING.md:75
240+ #: ../../CONTRIBUTING.md:83
220241msgid "Before you submit your pull request"
221242msgstr ""
222243
223- #: ../../CONTRIBUTING.md:77
244+ #: ../../CONTRIBUTING.md:85
224245msgid ""
225246"*__TODO__: This section should describe what steps a user should follow "
226247"before submitting the pull request: build the docs, verify your changes "
227248"look correct, etc.*"
228249msgstr ""
229250
230- #: ../../CONTRIBUTING.md:79
251+ #: ../../CONTRIBUTING.md:87
231252msgid "Submitting a pull request with your contribution"
232253msgstr ""
233254
234- #: ../../CONTRIBUTING.md:81
255+ #: ../../CONTRIBUTING.md:89
235256msgid "How to make a pull request"
236257msgstr ""
237258
238- #: ../../CONTRIBUTING.md:83
259+ #: ../../CONTRIBUTING.md:91
239260msgid ""
240261"*__TODO__: This section should describe how to make a pull request in "
241262"GitHub.*"
242263msgstr ""
243264
244- #: ../../CONTRIBUTING.md:85
265+ #: ../../CONTRIBUTING.md:93
245266msgid "What happens when you submit a pull request (CI/CD)"
246267msgstr ""
247268
248- #: ../../CONTRIBUTING.md:87
269+ #: ../../CONTRIBUTING.md:95
249270msgid ""
250271"*__TODO__: This section should describe how to see the results of the "
251272"CD/CI checks and how to get more information about errors*"
252273msgstr ""
253274
254- #: ../../CONTRIBUTING.md:89
275+ #: ../../CONTRIBUTING.md:97
255276msgid "What to expect from the review process"
256277msgstr ""
257278
258- #: ../../CONTRIBUTING.md:91
279+ #: ../../CONTRIBUTING.md:99
259280msgid ""
260281"*__TODO__: This section should describe how review happens in GitHub, how"
261282" see the comments, and how to submit changes (push a new branch)*"
262283msgstr ""
263284
264- #: ../../CONTRIBUTING.md:93
285+ #: ../../CONTRIBUTING.md:101
265286msgid "Additional help"
266287msgstr ""
267288
268- #: ../../CONTRIBUTING.md:95
289+ #: ../../CONTRIBUTING.md:103
269290msgid "How to get help"
270291msgstr ""
271292
272- #: ../../CONTRIBUTING.md:97
293+ #: ../../CONTRIBUTING.md:105
273294msgid ""
274295"*__TODO__: This section should describe the options for finding more help"
275296" in case beginner contributors need more help (e.g., create an issue, "
276297"post in a forum, etc).*"
277298msgstr ""
278299
279- #: ../../CONTRIBUTING.md:99
300+ #: ../../CONTRIBUTING.md:107
280301msgid "Additional resources"
281302msgstr ""
282303
283- #: ../../CONTRIBUTING.md:101
304+ #: ../../CONTRIBUTING.md:109
284305msgid ""
285306"*__TODO__: It should also include links to beginner documentation, like "
286307"the GitHub docs.*"
287308msgstr ""
288309
289- #: ../../CONTRIBUTING.md:103
310+ #: ../../CONTRIBUTING.md:111
290311msgid "Annex"
291312msgstr ""
292313
293- #: ../../CONTRIBUTING.md:105
314+ #: ../../CONTRIBUTING.md:113
294315msgid "Code examples"
295316msgstr ""
296317
297- #: ../../CONTRIBUTING.md:107
318+ #: ../../CONTRIBUTING.md:115
298319msgid ""
299320"This guide uses the [literalinclude Sphinx directive](https://www.sphinx-"
300321"doc.org/en/master/usage/restructuredtext/directives.html#directive-"
301322"literalinclude) whenever possible to keep code and prose separate. Code "
302323"for use in the documentation is kept in the `examples/` folder."
303324msgstr ""
304325
305- #: ../../CONTRIBUTING.md:111
326+ #: ../../CONTRIBUTING.md:119
306327msgid "Referencing code in documentation"
307328msgstr ""
308329
309- #: ../../CONTRIBUTING.md:113
330+ #: ../../CONTRIBUTING.md:121
310331msgid ""
311332"If an example is present elsewhere in the documentation that you want to "
312333"use, you can copy the `literalinclude` directive verbatim and the "
313334"examples will stay in sync."
314335msgstr ""
315336
316- #: ../../CONTRIBUTING.md:116
337+ #: ../../CONTRIBUTING.md:124
317338msgid ""
318339"If you already see code in the examples folder that you can use for new "
319340"documentation, a new `literalinclude` can be made to extract it into the "
@@ -323,25 +344,25 @@ msgid ""
323344"the later can protect your example from future modifications to the code."
324345msgstr ""
325346
326- #: ../../CONTRIBUTING.md:121
347+ #: ../../CONTRIBUTING.md:129
327348msgid ""
328349"**Pro tip**: As an alternative to `:lines:` there are also the `:start-"
329350"after:`, `:start-at:`, `:end-before:`, and `:end-at:` options. And if the"
330351" example code is Python, `:pyobject:` can be an even more future-proof "
331352"way to keep the same documentation content even through code refactors."
332353msgstr ""
333354
334- #: ../../CONTRIBUTING.md:125
355+ #: ../../CONTRIBUTING.md:133
335356msgid ""
336357"If you need example code that doesn't yet exist in `examples/` see "
337358"creating code for documentation](#creating-code-for-documentation)."
338359msgstr ""
339360
340- #: ../../CONTRIBUTING.md:128
361+ #: ../../CONTRIBUTING.md:136
341362msgid "Creating code for documentation"
342363msgstr ""
343364
344- #: ../../CONTRIBUTING.md:130
365+ #: ../../CONTRIBUTING.md:138
345366msgid ""
346367"Whenever you come across a place that could benefit from a code block, "
347368"instead of writing it in-line with a code fence (`` ``` `` blocked text) "
@@ -350,7 +371,7 @@ msgid ""
350371"code-in-documentation)."
351372msgstr ""
352373
353- #: ../../CONTRIBUTING.md:134
374+ #: ../../CONTRIBUTING.md:142
354375msgid ""
355376"If you want to add a new example that doesn't fit into any of the "
356377"existing example files, you can create a new file and reference it in a "
@@ -359,7 +380,7 @@ msgid ""
359380"create a new folder in the `examples` directory."
360381msgstr ""
361382
362- #: ../../CONTRIBUTING.md:138
383+ #: ../../CONTRIBUTING.md:146
363384msgid ""
364385"If an existing example is incomplete or a new example makes sense to be "
365386"added to an existing file, go ahead and add it, but take care to not "
@@ -368,14 +389,14 @@ msgid ""
368389"file, new methods after all existing ones in a class."
369390msgstr ""
370391
371- #: ../../CONTRIBUTING.md:142
392+ #: ../../CONTRIBUTING.md:150
372393msgid ""
373394"Example code is checked for correctness, so adding a new example may "
374395"require adding additional tests for coverage, and will require fixing any"
375396" failing tests."
376397msgstr ""
377398
378- #: ../../CONTRIBUTING.md:145
399+ #: ../../CONTRIBUTING.md:153
379400msgid ""
380401"***⚠️ WARNING***: great care should be taken when modifying existing "
381402"example code, especially any modification beyond appending to the end of "
@@ -386,29 +407,43 @@ msgid ""
386407"and then checking those pages in a new build."
387408msgstr ""
388409
389- #: ../../CONTRIBUTING.md:153
410+ #: ../../CONTRIBUTING.md:161
390411msgid "Example:"
391412msgstr ""
392413
393- #: ../../CONTRIBUTING.md:155
414+ #: ../../CONTRIBUTING.md:163
394415msgid "Instead of writing example code in markdown like this"
395416msgstr ""
396417
397- #: ../../CONTRIBUTING.md:166
418+ #: ../../CONTRIBUTING.md:174
398419msgid "The python can be extracted into a `.py` file"
399420msgstr ""
400421
401- #: ../../CONTRIBUTING.md:180
422+ #: ../../CONTRIBUTING.md:188
402423msgid ""
403424"As another example, if you only need to show part of a `pyproject.toml`, "
404425"we already have complete project definitions, you need only to find the "
405426"relevant part."
406427msgstr ""
407428
408- #: ../../CONTRIBUTING.md:183
429+ #: ../../CONTRIBUTING.md:191
409430msgid "Instead of writing this"
410431msgstr ""
411432
412- #: ../../CONTRIBUTING.md:195
433+ #: ../../CONTRIBUTING.md:203
413434msgid "an example could be extracted from an existing toml file"
414435msgstr ""
436+
437+ #~ msgid ""
438+ #~ "Independently of the approach you "
439+ #~ "choose, the first step is to fork"
440+ #~ " the Python Packaging Guide repository "
441+ #~ "into your personal GitHub space."
442+ #~ msgstr ""
443+
444+ #~ msgid ""
445+ #~ "*__TODO__: This section should show a"
446+ #~ " beginner user how to fork a "
447+ #~ "repository in GitHub.*"
448+ #~ msgstr ""
449+
0 commit comments