Skip to content

Commit 00aca1c

Browse files
committed
Update readme
1 parent 03a620e commit 00aca1c

File tree

2 files changed

+26
-107
lines changed

2 files changed

+26
-107
lines changed

README.html

Lines changed: 22 additions & 103 deletions
Original file line numberDiff line numberDiff line change
@@ -366,44 +366,17 @@ <h2>Authors</h2>
366366
<h2>Description</h2>
367367
<p>This 3-hour lesson is organized into three main sections covering:
368368
open, collaborative, and inclusive science; FAIR and CARE principles;
369-
and Latin American initiatives and practices. The declaration of 2023 as
370-
the Year of Open Science by NASA and other federal US agencies reflects
371-
the belief that open science is a pillar to ensure information access
372-
and the democratization of the scientific process. As Chelle Gentemann,
373-
program scientist for NASA’s Transform to Open Science (TOPS) mission,
374-
recently shared in Nature, “I realized that open science isn’t just
375-
about tools. Open-science innovation is being driven by a global
376-
community with diverse perspectives. The scientific questions are more
377-
interesting and nuanced, the solutions better.” We want to share how
378-
open science communities, especially those from marginalized regions
379-
like Latin America, actively participate in implementing, educating, and
380-
disseminating open practices and resources. Open science communities and
381-
organizations are settings where researchers and societal stakeholders
382-
can meet to achieve results that are not only technically but also
383-
socially meaningful through the use of transparent, reproducible, and
384-
verifiable methods with contributors from different regions,
385-
disciplines, and social realities. Non-native English-speaking
386-
researchers, educators, and professionals frequently face difficulties
387-
obtaining the resources they need to carry out their work, being limited
388-
by lack of funding, language barriers, and geographical limitations.
389-
Bringing experiences from Spanish-speaking communities of practice, we
390-
will work with librarians to discuss the challenges faced by such
391-
communities when dealing with data and other resources that are only
392-
available in English, making language an accessibility barrier. We will
393-
discuss aspects of how open science practices may help marginalized
394-
communities of scholars get past barriers caused by language,
395-
socioeconomic status, and other factors in order to foster a more
396-
inclusive scientific community. We will introduce open science concepts
397-
and principles, with great emphasis on applying FAIR principles to
398-
library work in order to make data more findable, accessible,
399-
interoperable, and reproducible. With examples from Latin American data
400-
governance projects to show many paths to open science, we will also
401-
include the CARE Principles for Indigenous Data Governance to highlight
402-
the significance of ethical and responsible work with data for fostering
403-
self-determination. The lesson will present concepts of
369+
and Latin American initiatives and practices. We will introduce open
370+
science concepts and principles, with emphasis on applying FAIR
371+
principles to library work in order to make data more findable,
372+
accessible, interoperable, and reproducible. With examples from Latin
373+
American data governance projects to show many paths to open science, we
374+
will also include the CARE Principles for Indigenous Data Governance to
375+
highlight the significance of ethical and responsible work with data for
376+
fostering self-determination. The lesson will present concepts of
404377
community-building and collaboration in open research, relating them to
405378
local content sources such as ILDA, Latindex, the National System of
406-
Digital Repositories and the Argentinean mapping of citizen science
379+
Digital Repositories, and the Argentinean mapping of citizen science
407380
initiatives. We will also share our experience teaching diverse
408381
audiences at MetaDocencia, an inclusive community to develop
409382
evidence-based open teaching practices and materials and build technical
@@ -415,77 +388,23 @@ <h2>Description</h2>
415388
<div id="keywords" class="section level3">
416389
<h3>Keywords</h3>
417390
<p>Open access, open science, open data, open educational resources,
418-
Spanish-speaking communities</p>
391+
spanish-speaking communities.</p>
392+
</div>
393+
</div>
394+
<div id="rendered-version-of-the-lesson" class="section level2">
395+
<h2>Rendered version of the lesson</h2>
419396
<p>This lesson is a template lesson that uses <a href="https://carpentries.github.io/sandpaper-docs/">The Carpentries
420397
Workbench</a>.</p>
398+
<p>Version: pre-alpha</p>
421399
</div>
400+
<div id="contact-information" class="section level2">
401+
<h2>Contact information</h2>
402+
<p>If you have any questions, contact <a href="mailto:[email protected]">Irene Vazano</a></p>
422403
</div>
423-
<div id="create-a-new-repository-from-this-template" class="section level2">
424-
<h2>Create a new repository from this template</h2>
425-
<p>To use this template to start a new lesson repository, make sure
426-
you’re logged into Github.<br />
427-
Visit <a href="https://github.com/carpentries/workbench-template-md/generate" class="uri">https://github.com/carpentries/workbench-template-md/generate</a>
428-
and follow the instructions. Checking the ‘Include all branches’ option
429-
will save some time waiting for the first website build when your new
430-
repository is initialised.</p>
431-
<p>If you have any questions, contact <a href="https://github.com/zkamvar"><span class="citation">@zkamvar</span></a></p>
432-
</div>
433-
<div id="configure-a-new-lesson" class="section level2">
434-
<h2>Configure a new lesson</h2>
435-
<p>Follow the steps below to complete the initial configuration of a new
436-
lesson repository built from this template:</p>
437-
<ol style="list-style-type: decimal">
438-
<li><strong>Make sure GitHub Pages is activated:</strong> navigate to
439-
<em>Settings</em>, select <em>Pages</em> from the left sidebar, and make
440-
sure that <code>gh-pages</code> is selected as the branch to build from.
441-
If no <code>gh-pages</code> branch is available, check <em>Actions</em>
442-
to see if the first website build workflows are still running. The
443-
branch should become available when those have completed.</li>
444-
<li><strong>Adjust the <code>config.yaml</code> file:</strong> this file
445-
contains global parameters for your lesson site. Individual fields
446-
within the file are documented with comments (beginning with
447-
<code>#</code>) At minimum, you should adjust all the fields marked
448-
‘FIXME’:
449-
<ul>
450-
<li><code>title</code></li>
451-
<li><code>created</code></li>
452-
<li><code>keywords</code></li>
453-
<li><code>life_cycle</code> (the default, <em>pre-alpha</em>, is the
454-
appropriate for brand new lessons)</li>
455-
<li><code>contact</code></li>
456-
</ul></li>
457-
<li><strong>Annotate the repository</strong> with site URL and topic
458-
tags: navigate back to the repository landing page and click on the gear
459-
wheel/cog icon (similar to ⚙️) at the top-right of the <em>About</em>
460-
box. Check the “Use your GitHub Pages website” option, and <a href="https://cdh.carpentries.org/the-carpentries-incubator.html#topic-tags">add
461-
some keywords and other annotations to describe your lesson</a> in the
462-
<em>Topics</em> field. At minimum, these should include:
463-
<ul>
464-
<li><code>lesson</code></li>
465-
<li>the life cycle of the lesson (e.g. <code>pre-alpha</code>)</li>
466-
<li>the human language the lesson is written in
467-
(e.g. <code>deutsch</code>)</li>
468-
</ul></li>
469-
<li><strong>Adjust the <code>CODE_OF_CONDUCT.md</code>,
470-
<code>CONTRIBUTING.md</code>, and <code>LICENSE.md</code> files</strong>
471-
as appropriate for your project.
472-
<ul>
473-
<li><code>CODE_OF_CONDUCT.md</code>: if you are using this template for
474-
a project outside The Carpentries, you should adjust this file to
475-
describe who should be contacted with Code of Conduct reports, and how
476-
those reports will be handled.</li>
477-
<li><code>CONTRIBUTING.md</code>: depending on the current state and
478-
maturity of your project, the contents of the template Contributing
479-
Guide may not be appropriate. You should adjust the file to help guide
480-
contributors on how best to get involved and make an impact on your
481-
lesson.</li>
482-
<li><code>LICENSE.md</code>: in line with the terms of the CC-BY
483-
license, you should ensure that the copyright information provided in
484-
the license file is accurate for your project.</li>
485-
</ul></li>
486-
<li><strong>Update this README with <a href="https://carpentries.github.io/lesson-development-training/26-external.html#readme">relevant
487-
information about your lesson</a></strong> and delete this section.</li>
488-
</ol>
404+
<div id="contributing-information" class="section level2">
405+
<h2>Contributing information</h2>
406+
<p>Follow the <a href="./CONTRIBUTING.md">Contributing</a> steps to know
407+
how to get involved and make an impact on the lesson.</p>
489408
</div>
490409
</div>
491410

README.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -14,17 +14,17 @@ We will introduce open science concepts and principles, with emphasis on applyin
1414

1515
Open access, open science, open data, open educational resources, spanish-speaking communities.
1616

17-
## rendered version of the lesson
17+
## Rendered version of the lesson
1818

1919
This lesson is a template lesson that uses [The Carpentries Workbench][workbench].
2020

2121
Version: pre-alpha
2222

23-
## contact information
23+
## Contact information
2424

25-
If you have any questions, contact [@Airo](https://github.com/4iro)
25+
If you have any questions, contact Irene Vazano at [[email protected]](mailto:irene.vazano@gmail.com)
2626

27-
## contributing information
27+
## Contributing information
2828

2929
Follow the [Contributing](./CONTRIBUTING.md) steps to know how to get involved and make an impact on the lesson.
3030

0 commit comments

Comments
 (0)