Merge pull request #89 from rockandror/fix-docs
Improve texts and fix links
This commit is contained in:
@@ -1,6 +1,6 @@
|
||||
# Personalización
|
||||
|
||||
Puedes modificar CONSUL y ponerle tu propia imagen, para esto debes primero [crear tu propio fork](forks/create.md).
|
||||
Puedes modificar CONSUL y ponerle tu propia imagen, para esto debes primero [crear tu propio fork](../getting_started/create.md).
|
||||
|
||||
Hemos creado una estructura específica donde puedes sobreescribir y personalizar la aplicación para que puedas actualizar sin que tengas problemas al hacer merge y se sobreescriban por error tus cambios. Intentamos que CONSUL sea una aplicación Ruby on Rails lo más plain vanilla posible para facilitar el acceso de nuevas desarrolladoras.
|
||||
|
||||
|
||||
@@ -10,8 +10,8 @@
|
||||
|
||||
3. Si se te solicita acceso a tu cuenta de Github por parte de Travis CIaccess, marca la organización o usuario bajo el cual reside tu fork de Consul y haz click en el botón "**Authorize travis-ci**".
|
||||
|
||||
4. Visit [your travis profile](https://travis-ci.org/profile/) and enable Travis for your Consul fork on the repositories list that will appear.
|
||||
4. Visita [tu perfil en Travis](https://travis-ci.org/profile/) y habilita Travis para tu fork de Consul en el listado de repositorios.
|
||||
|
||||
5. Click on the cog button next to your recenlty enabled consul repository to check the builds.
|
||||
5. Haz click en el icono de un piñón a la derecha del repositorio para ver las builds.
|
||||
|
||||
6. Try it out by creating a test Pull Request against your fork (editing a .md file should do the trick)
|
||||
6. Comprueba que todo está bien configurado creando un Pull Request de prueba (editar un simple fichero .md podría servir).
|
||||
|
||||
@@ -10,7 +10,7 @@ El repositorio git de Consul está hospedado en Github.com, recomendamos lo uses
|
||||
|
||||
4. [Clona el repositorio de tu fork](https://help.github.com/articles/cloning-a-repository/) en tu ordenador
|
||||
|
||||
****ADVERTENCIA IMPORTANTE**: No hagas un fork de `https://github.com/AyuntamientoMadrid/consul`, es una equivocación infrecuente que conlleva múltiples y graves problemas.
|
||||
****ADVERTENCIA IMPORTANTE**: No hagas un fork de `https://github.com/AyuntamientoMadrid/consul`, es una equivocación frecuente que conlleva múltiples y graves problemas.
|
||||
|
||||
## ¿Porqué hacer el código público?
|
||||
|
||||
|
||||
@@ -63,6 +63,6 @@ B. Se abre una ventana del editor que tengas configurado en git, mostrando el me
|
||||
|
||||
C. Recibes mensajes de error de git junto con un `Automatic merge failed; fix conflicts and then commit the result.`. Esto significa que se han encontrado conflictos entre los cambios en tu código y los cambios que se realizaron en CONSUL desde la última vez que actualizaste tu fork. Esta es una de las principales razones para intentar mantener tu fork lo más al dia posible, realizando este proceso al menos mensualmente. Resuelve manualmente los conflictos para terminar el merge y haz un commit.
|
||||
|
||||
Now you can just simply push **upstream** branch to github and create a Pull Request so you can easily check all changes going into your repo, and see your tests suite runs.
|
||||
Ahora simplemente sube la rama **upstream** a github y crea un Pull Request, así podrás ver de manera sencilla todos los cambios que se han realizado en el repositorio y verás también como arranca la suite de tests.
|
||||
|
||||
Recuerda que siempre puedes comprobar rápidamente los cambios que tienes pendientes de integrar de CONSUL a tu fork sustituyendo **your_org_name** en la url: https://github.com/your_org_name/consul/compare/master...consul:master
|
||||
|
||||
@@ -68,4 +68,4 @@ Por defecto encontrarás en CONSUL diferentes formas de participación para los
|
||||
Encontrarás diversas funcionalidades con los nombres de los diferentes canales de participación "Debates", "Propuestas", "Votaciones", "Legislación Colaborativa" y "Presupuestos Participativos". Puedes desactivar cualquiera de las funcionalidades y dejará de mostrarse en tu instalación de CONSUL.
|
||||
|
||||
### Más información y documentación detallada
|
||||
Estas opciones anteriores te permitirán tener una versión básica de CONSUL que empezar a usar. Te recomendamos acceder a la sección [Documentación y guías sobre CONSUL](../getting_started/consul_guides.md) donde podrás encontrar más documentación detallada.
|
||||
Estas opciones anteriores te permitirán tener una versión básica de CONSUL que empezar a usar. Te recomendamos acceder a la sección [Documentación y guías sobre CONSUL](documentation_and_guides.md) donde podrás encontrar más documentación detallada.
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
## Super usuario
|
||||
|
||||
El programa 'sudo' no viene instalado en Debian por defecto. Su instalación y configuración es posible, se puede encontrar informacion al respecto [aquí](https://wiki.debian.org/es/sudo). Pero no lo recomendamos porque puede causar otros problemas. Recomendamos que se ejecuten las siguientes instrucciones como un super usuario, así que asegúrate de que la primera instrucción que ejecutes sea:
|
||||
El programa 'sudo' no viene instalado en Debian por defecto. Su instalación y configuración es posible, se puede encontrar información al respecto [aquí](https://wiki.debian.org/es/sudo). Pero no lo recomendamos porque puede causar otros problemas. Recomendamos que se ejecuten las siguientes instrucciones como un super usuario, así que asegúrate de que la primera instrucción que ejecutes sea:
|
||||
|
||||
```
|
||||
su
|
||||
@@ -39,7 +39,7 @@ apt-get install curl
|
||||
|
||||
## Ruby
|
||||
|
||||
Las versiones de Ruby versions empaquetadas en repositorios oficiales no son aptas para trabajar con consul (al menos Debian 7 y 8), así que debemos instalar manualmente.
|
||||
Las versiones de Ruby empaquetadas en repositorios oficiales no son aptas para trabajar con consul, así que debemos instalar manualmente.
|
||||
|
||||
El método recomendado es via rvm:
|
||||
|
||||
@@ -51,7 +51,7 @@ command curl -sSL https://rvm.io/pkuczynski.asc | gpg --import -
|
||||
curl -L https://get.rvm.io | bash -s stable
|
||||
```
|
||||
|
||||
despues añadimos el script rvm a nuestro bash (~/.bashrc) (este paso sólo es necesario si no puedes ejecutar el comando rvm)
|
||||
después añadimos el script rvm a nuestro bash (source /root/.bashrc) (este paso sólo es necesario si no puedes ejecutar el comando rvm)
|
||||
|
||||
```
|
||||
[[ -s /usr/local/rvm/scripts/rvm ]] && source /usr/local/rvm/scripts/rvm
|
||||
@@ -71,7 +71,7 @@ rvm install 2.4.9
|
||||
|
||||
## Bundler
|
||||
|
||||
lo instalammos usando
|
||||
lo instalamos usando
|
||||
|
||||
```
|
||||
gem install rubygems-bundler
|
||||
@@ -172,4 +172,4 @@ También tienes la opción de solo instalar ChromeDriver desde AUR. Si usas `pac
|
||||
pacaur -S chromedriver
|
||||
```
|
||||
|
||||
> Ya estás listo para [instalar Consul](local_installation.md)!!
|
||||
Ya estás listo para [instalar Consul](local_installation.md)!!
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
# Usando Docker para desarrollo en local
|
||||
|
||||
Puedes usar Docker para tener una instalación local de CONSUL si:
|
||||
- Estás teniendo problemas para instalar los [prerrequisitos](prerequisites) correctamente.
|
||||
- Estás teniendo problemas para instalar los [prerrequisitos](prerequisites.md) correctamente.
|
||||
- Quieres tener una instalación local rápidamente para probar o hacer una demo.
|
||||
- Prefieres no interferir con instalaciones de apps Rails existentes.
|
||||
|
||||
@@ -112,7 +112,7 @@ Deberías obtener algo similar a:
|
||||
Pendiente de ser completado... ¡Se agradecen las Contribuciones!
|
||||
|
||||
|
||||
## ¿Habiendo problemas?
|
||||
## ¿Tienes problemas?
|
||||
Ejecute los comandos en el **directorio de CONSUL**, para borrar todas las imágenes y contenedores anteriores del Docker de CONSUL. Luego, reinicie el [proceso de instalación](#instalación) de Docker:
|
||||
|
||||
1. Quitar todas las imágenes de CONSUL:
|
||||
@@ -123,13 +123,13 @@ docker-compose down --rmi all -v --remove-orphans
|
||||
2. Quitar todos los contenedores de CONSUL
|
||||
```bash
|
||||
docker-compose rm -f -s -v
|
||||
```
|
||||
```
|
||||
|
||||
3. Verificar si todavía hay algún contenedor:
|
||||
```bash
|
||||
docker ps -a
|
||||
docker ps -a
|
||||
```
|
||||
Caso positivo, eliminar cada uno de forma manual:
|
||||
```bash
|
||||
docker container rm <container_id>
|
||||
```
|
||||
```
|
||||
|
||||
@@ -108,31 +108,4 @@ brew install chromedriver
|
||||
brew install imagemagick
|
||||
```
|
||||
|
||||
## Clonar el repositorio
|
||||
|
||||
Ahora que ya tenemos todas las dependencias instalado podemos bajarnos el proyecto:
|
||||
|
||||
```
|
||||
git clone https://github.com/consul/consul.git
|
||||
cd consul
|
||||
bundle install
|
||||
cp config/database.yml.example config/database.yml
|
||||
cp config/secrets.yml.example config/secrets.yml
|
||||
```
|
||||
|
||||
Ahora copia en `database.yml` el usuario y la contraseña que pusiste para *consul*. Cuando ya lo hayas hecho:
|
||||
|
||||
```
|
||||
rake db:create
|
||||
rake db:setup
|
||||
rake db:dev_seed
|
||||
RAILS_ENV=test bin/rake db:setup
|
||||
```
|
||||
|
||||
Para ejecutar los tests:
|
||||
|
||||
```
|
||||
bundle exec rspec
|
||||
```
|
||||
|
||||
> Ya estás listo para [instalar Consul](../local_installation.html)!!
|
||||
Ahora que ya tenemos todas las dependencias instalado podemos bajarnos el proyecto: [instalar Consul](local_installation.md)
|
||||
|
||||
@@ -4,4 +4,3 @@
|
||||
* [Debian Linux](debian.md)
|
||||
* [MacOS](macos.md)
|
||||
* [Windows](windows.md)
|
||||
|
||||
|
||||
@@ -18,7 +18,7 @@ sudo apt install git
|
||||
|
||||
## Ruby
|
||||
|
||||
Las versiones de Ruby versions empaquetadas en repositorios oficiales no son aptas para trabajar con CONSUL, así que debemos instalarlo manualmente.
|
||||
Las versiones de Ruby empaquetadas en repositorios oficiales no son aptas para trabajar con CONSUL, así que debemos instalarlo manualmente.
|
||||
|
||||
En primer lugar, necesitamos los siguiente paquetes para poder instalar Ruby:
|
||||
|
||||
|
||||
@@ -1,3 +1,3 @@
|
||||
# Windows
|
||||
|
||||
De momento Windows no es un sistema operativo compatible. Por favor instale [Virtual Box](https://www.virtualbox.org/) para crear una máquina virtual en [Linux](prerequisites).
|
||||
De momento Windows no es un sistema operativo compatible. Por favor instale [Virtual Box](https://www.virtualbox.org/) para crear una máquina virtual en [Linux](prerequisites.md).
|
||||
|
||||
Reference in New Issue
Block a user