Saltar al contenido principal

INSTRUCTIVO - Cómo subir documentación en Silstech Docs

· 3 min de lectura
Franco R.
El chico de software @ sils.tech

¿Qué vas a necesitar?

  • Un usuario developer en la plataforma de Gitlab.
  • Documento fuente para agregar.
  • Nombre del módulo o funcionalidad a documentar.

Paso 1 - Ingreso al Blog

Ingresá a https://docs.sils.tech/admin/ e iniciar sesión. Se abrirá la plataforma Decap que permite loguarte a través de Gitlab.

Se abrirá una ventana para autorizar el ingreso. Hacer clic en “Autorizar”

Paso 2 -  Entender la estructura del espacio de carga

Luego de autorizarte el ingreso a la cuenta, se abrirá un espacio con toda la información cargada hasta este momento en Silstech Docs.

  • Contenido: Muestra las colecciones cargadas hasta el momento en Blog. 
  • Medios: Permite copiar, eliminar, descargar, subir un archivo multimedia (imágenes, videos, audio)
  • Colecciones: Son los Post que se crean para cargar la información. Permite desplegar el contenido cargado en formato menú.
  • Espacio de carga: Posibilita cargar Nuevo Docs (en el espacio del tema seleccionado)
  • Añadir rápido: Permite cargar un Post en el menú de manera más directa.

Paso 3 - Acceder a la ventana de carga y edición

  • Para comenzar a cargar la información en un tema ya existente en el menú, posiciona el cursor sobre el tema.
  • En la sección de carga apretar el botón Nuevo Docs, se abrirá el espacio de edición.

  • Completar los espacios de:

    • Título (aparecerá en el menú)
    • Posición (lugar donde se encontrará el documento dentro del menú o submenú.
    • Contenido.
  • Si estás cargando en el espacio de Blog, también poder incoporar: Fecha, Autores, Tags.

Paso 4 - Carga de contenido

  • El espacio de contenido permite comenzar a cargar la documentación y modificar el texto con las herramientas de edición (1). Para esto dejar activada la opción “Texto enriquecido”. 
  • También, se puede cargar la información en formato Markdown (2)

  • Al hacer clic en el símbolo + se despliegan las opción de cargar con código. Se pueden ir agregando debajo tantos bloques de código como se necesiten.

  • El mismo signo + permite cargar o insertar desde URL imágenes.

A medida que se vaya escribiendo la documentación, la misma se podrá pre visualizar en la ventana lateral derecha, como en el siguiente ejemplo:

Es importante Guardar el documento por primera, para asegurarte de volver a ingresar con los cambios último realizados.

Una vez guardado se habilitarán las opciones:

Estado. Podés seleccionar las opciones de Borrador, En revisión o Listo según corresponda. En nuestro caso, como colaboradores del espacio solo podemos elegir Borrador y En revisión.

Publicar. Luego de controlar (sintaxis, ortografía) el contenido cargado, podés seleccionar Publicar ahora, Publicar y crear nuevo, Publicar y duplicar.

Eliminar entrada no publicada.

Paso 5 - Editar un documento guardado

Si el documento se guardó correctamente, aparecerá un mensaje en color verde a modo de confirmación. Para editar el documento, podés volver a la pantalla inicial del menú para elegir el documento guardado. Al seleccionarlo se abrirá nuevamente la ventana de edición.

Cuando los cambios estén listos, proceder a Guardar y dejar el documento en estado En revisión

Paso 6 - Habilitación del documento en Silstech Docs

Al momento de colocar tu documento en estado Revisión, el administrador del sitio será el encargado de habilitar la visualización del mismo en Silstech Docs. Este paso no es automático.

Reseteo Aibox usando placa

· 3 min de lectura
Franco R.
El chico de software @ sils.tech

Problemática detectada

Un problema recurrente que sucede con los DVR AIBOX es que en cierto momento dejan de reportar todo tipo de eventos con lo cual perdemos (y pierde el cliente) total visibilidad con el vehículo que contiene el dispositivo. Esto trae aparejado un problema económico contractual que debemos afrontar como proveedores, al menos en el caso YPF.

Mover datos históricos y borrar

· 5 min de lectura
Franco R.
El chico de software @ sils.tech

Al consultar ciertas tablas de MySql notamos que tienen una cantidad excesiva de filas. Acá veremos una forma de hacer una copia de los datos en un dataset de BigQuery por un lado, y por el otro la posibilidad de borrar los datos de MySql.

Guía de Desarrollo Frontend

· 5 min de lectura
Software Bugs generator @ sils.tech

Esta guía establece los patrones arquitectónicos y criterios de desarrollo utilizados en el Dashboard General. Sirve como referencia para mantener consistencia en el desarrollo de nuevas features o vistas similares.

Cleanup old data from datastore

· 5 min de lectura
Franco R.
El chico de software @ sils.tech

Impulsado por la necesidad de reducir costos en Google Cloud Platform me encontré un alto costo en un proyecto relacionado a Cloud Firestore Storage. Analizando el Datastore vi que tenía el siguiente tamaño

Migrar a MySql 8.x

· 2 min de lectura
Franco R.
El chico de software @ sils.tech

La intención es plasmar los impedimentos con sus soluciones que encontré al actualizar la versión de MySQL de 5.7 a 8.0.

El problema no está en hacer el upgrade desde GCP, sino algunas queries que no son exactamente iguales en la versión 8.x, sobre todo las relacionadas a consultas sobre columnas Geometry. Para solucionar estos problemas ver la sección sobre columnas geometry.

Otro error detectado en los logs se produce en la función cron-jobs-executer que al intentar correr uno de los jobs, la consulta falla por problemas de compatibilidad. Ver en la sección.

Midiendo trazabilidad con Grafana Tempo

· 4 min de lectura
Julián Sánchez
Software Developer @sils.tech

Introducción

En los ultimos meses varios cambios significativos se dieron en el equipo y en la plataforma debido a la implementación paneles de monitoreo y recolección de metricas en algunos de nuestros servicios. Algunos de estos cambios llevaron a la detección de ataques maliciosos en nuestra infraestructura y mejoras significativas en el rendimiento de la plataforma tales como caidas, errores y alta disponibilidad.

Arquitectura de Node.js

· 18 min de lectura
Software Bugs generator @ sils.tech

¿Qué es V8 y por qué es importante?

V8 es el motor JavaScript desarrollado en C++ que convierte el código JavaScript en código máquina. Es utilizado tanto en Chrome como en Node.js, y soporta tanto ECMAScript como WebAssembly.