N.B. This is a testing repo, not real one: it will appear and disappear from the develop and arrival-pending branches only.
Its use is for developing Arnold, the automator. He will handle tasks silently and usefully, so that repos rapidly arrive or disappear on our web apps, whenver they enter or leave branches of CombatCovid.
See this documentation example. You can also download it to see the final result.
Use this template and guidelines to make your documentation more FAIR (Findable Accessible Interoperable and Reusable). The template has a simple structure that allows to easily present your content separating the source files(src) that users need to replicate from explanations (docs), and guides that explain how to use the source files.
- Download or clone this template to start documenting easily.
- Replace the content in this
README.md
file with content that describes the key features of your project. Consider it the entry point for the users of your content.
- Fill in the source files like STLS, CAD, etc inside the
./src
folder. - Inside
./docs/img/
put images that describe visually your hardware design. - Describe in markdown inside
.docs/
how the content in the./src
folder should be used. This is where you provide some context and description on how to replicate and use your design. - Inside
./docs/LANGUAGE-CHOSEN
write down a simple README in your language of choice, for example./docs/NL
. - Write down steps to replicate if necessesary as well as guides in sequence.
If this part becomes difficult ask for help here in the #how-to-document-designs
channel .
- Fill in the fields in the
metadata.yaml
file at the root of this folder. - Describe more extensively your project in
metadataExtended.yaml
. - Replace the
summary.jpg
image with the one that shows your design using the same name.
- If you don't know how to do it we can help you.
- Upload your repository to CombatCovid org, alternatively upload it in your private repo and let us know so that we can fork it and put it in list.
If you want to translate the content in the docs
folder for instance to Russian or French, a simple way to do it is to first open the new folder inside docs
for instance docs/FR
, and put the texts in google translate, to then refine and correct the translation.
- Create automatically EPUBs, and PDFs from markdown files.
Vea este ejemplo de documentación También puedes descargarlo para ver el resultado final.
Use esta plantilla y pautas para hacer que su documentación sea MÁS JUSTA (interoperable, accesible y reutilizable). La plantilla tiene una estructura simple que permite presentar fácilmente su contenido separando los archivos fuente (src) que los usuarios necesitan replicar de las explicaciones (documentos) y guías que explican cómo usar los archivos fuente.
- Descargue o clone esta plantilla para comenzar a documentar fácilmente.
- Reemplace el contenido de este archivo
README.md
con contenido que describa las características clave de su proyecto. Considérelo el punto de entrada para los usuarios de su contenido.
- Complete los archivos de origen como STLS, CAD, etc. dentro de la carpeta
. / Src
. - Dentro de
. / Docs / img /
coloque imágenes que describan visualmente su diseño de hardware. - Describa en markdown dentro de
.docs /
cómo se debe usar el contenido en la carpeta. / Src
. Aquí es donde proporciona un contexto y una descripción sobre cómo replicar y usar su diseño. - Dentro de
. / Docs / LANGUAGE-CHOSEN
escriba un LÉAME simple en el idioma que elija, por ejemplo. / Docs / NL
. - Escriba los pasos para replicar si es necesario, así como las guías en secuencia.
Si esta parte se vuelve difícil, solicite ayuda aquí en el canal # how-to-document-designs
.
- Complete los campos en el archivo
metadata.yaml
en la raíz de esta carpeta. - Describa más ampliamente su proyecto en
metadataExtended.yaml
. - Reemplace la imagen
summary.jpg
con la que muestra su diseño con el mismo nombre.
- Si no sabes cómo hacerlo, podemos ayudarte.
- Cargue su repositorio en la organización CombatCovid, alternativamente cárguelo en su repositorio privado y háganos saber para que podamos bifurcarlo y ponerlo en la lista.
Si desea traducir el contenido de la carpeta docs
, por ejemplo, al ruso o al francés, una forma sencilla de hacerlo es abrir primero la nueva carpeta dentro de docs
, por ejemplo, docs / FR
, y poner los textos en traductor de google, para luego refinar y corregir la traducción.
- Cree automáticamente EPUB y PDF a partir de archivos de descuento.
- now we have a fork, for a pr test
- and another, further on